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Introduction 


This manual provides condensed information about the RT-11 
monitor and utilities. The information is presented in compact 
form for your easy reference while working on your computer 
system. The mini-reference is not an explanatory guide, but 
rather a reminder to help you recall details of the system. 

Because each RT-11 user has different reference needs, you 
will probably want to add your own reference pages. This binder 
holds regular tractor-feed line printer paper; you can print your 
own reference pages on your system’s printer. The LAI 20 
printer, set to print a reduced character size, is particularly effec¬ 
tive for this purpose. 







Documentation Conventions 


The following documentation conventions are used in this man¬ 
ual: 

Square brackets, if not identified as required syntax, indicate an 
[optional] argument 

( surround j 

contain \ items from which you choose only one 
enclose j 

Boldface type indicates default or assumed settings 

Ellipses ... follow information that you can repeat 

Color identifies the shortest permissible abbreviated forms of 
commands 

lowercase letters indicate variables for which you supply an ap¬ 
propriate value 

UPPERCASE LETTERS indicate commands which you must 
type as shown 

The term filespec represents an RT-11 device, filename, and file 
type in the form dev:filnam.typ 

t xxx ) represents a special key on the terminal, for example, the 
space (sp) key 

Ctrl/D represents a control character, which you enter by typing 
the indicated key (x) while holding down the ffiDkey 

The term date represents a calendar date, which should be en¬ 
tered in the form dd:mmm:yy (for example, 18:MAR:83); if shown 
as optional, the default is the current system date. Dates entered 
as part of a Digital Command Language (DCL) command are 
assumed to be decimal; dates entered as arguments to utility 
program options require periods after the day and year to show 
that these numbers are decimal (for example, 18.:MAR:83.) 















RT-11 Keyboard Monitor Commands 
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ASSIGN de) physical-device-name dE) logical-device-name 

The ASSIGN command defines a logical name equivalent for a physical device. 
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B [de) address] 

The B command sets a relocation base for subsequent EXAMINE or DEPOSIT commands. 



BACKUP /DEVICE @ input-filespec @ output-filespec 

/RESTORE 
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The BASIC command runs the single-user BASIC interpreter. 






BOOT /FOREIGN © filespec 
/WAIT 



T3 

C 

CO 


E 

E 


8§ 
2 E 
40 <u 

SZ -O 

£2 
£ 0) 
CO E 
CD 3 

E o 
z> > 


£ CO 

o ~ 

o 5 

n £ 


£2 



4 





The CLOSE command enters permanently in a volume’s directory all files that are open after the background 
job terminates. 
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C — Control section names M — Macro names 
E — Error codes P — Permanent symbols 

R — Register symbols S — User-defined symbols 

no argument — equivalent to :E:M:S 












/DIAGNOSE expands crash dump information about compiler 

/DIBOL runs DIBOL compiler 

/DISABLE:type[...:type] specifies .DSABL directives; type can be 
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/14 allocates 2-word integers 

/LIBRARY identifies any macro library files 

/[NO]LINENUMBERS [does not] include line numbers in program 

/LIST[:filespec] outputs compiler or assembly listing to the line printer or to filespec 




/LOG creates log file of error messages 

/MACRO runs MACRO assembler 

/[NO]OBJECT[:filespec] [does not] generate a .OBJ file; default filename is input filename 
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0 — diagnostics only 

1 or SRC — source program and diagnostics 

2 or MAP — storage map and diagnostics 

3 — diagnostics, source program, and storage map 

4 or COD — generated code and diagnostics 
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The COPY command copies files from one location to another. 
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/[NO]LOG [does not] log names of copied files on terminal 

/MULTIVOLUME copies files from one large volume to several smaller volumes 

/NEWFILES copies only files with the current system date 
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/VERIFY compares copied output to input 

/WAIT waits for volume to be mounted before executing the command 



CREATE (D filespec /EXTENSIONS 
/STARTs 

/ALLOC ATE :size 
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The D command deposits values in memory beginning at the specified address. 





DATE [ dE) dd-mmm-yy] 
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The DEASSIGN command removes logical name assignments established with ASSIGN. DEASSIGN with 
no argument removes all assignments that are currently in effect. 
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The DELETE command deletes files from a volume’s directory or from the system queue. 
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/[N0]QUERY [does not] ask for confirmation before deleting each file 

/SINCE[:date] deletes files created on or after date 

/SYSTEM permits deletion of .SYS files 

/WAIT waits for volume to be mounted before executing the command 
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The DIBOL command runs the DIBOL compiler. 
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The DIFFERENCES command compares two files and lists the differences between them. 
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/ALLOCATE:size reserves space for output file; a size of -1 reserves the largest possible space 

/ALPHABETIZE lists directory entries in alphabetical order 
/BACKUP lists directory of a volume created by BUP 

/BADBLOCKS scans volume for bad blocks and lists their block numbers 






/BEFORE[:date] lists files created before date 

/BEGIN lists directory beginning at file you specify 

/BLOCKS includes starting block numbers of files and free areas in directory listing 

/BRIEF lists only file name and type; equivalent to /FAST 

/COLUMNS:n lists directory in o-column format 
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NAME — file name TYPE — file type 

POSITION — file position on the volume 






/OUTPUT:filespec specifies output device and filename for directory listing 
/OWNER:[nnn,nnn] specifies UIC for DOS-format volume; square brackets are part of syntax 
/POSITION lists files in the order that they occur on the volume; includes file sequence numbers 
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The DISMOUNT command frees a logical disk unit number from its associated file. 
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The DUMP command lists the contents of files in various formats. 
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The E command examines memory and displays the contents on the console terminal. 
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EDIT //EDIT \ ( /CREATE ) (D filespec 

l /KED I I /INSPECT ( /ALLOCATE:size 

) /KEX ( ) /OUTPUTrfilespec ( 
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/TECO runs the TECO editor 
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ABS — Generates absolute binary output 

AMA — Assembles absolute addresses as relative addresses 

CDR — Treats source columns beyond 72 as a comment 




DBG — Outputs internal symbol directory (ISD) records 

FPT — Truncates floating point 

GBL — Assumes undefined symbols are globals 
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SYM — Symbol table 

TOC — Table of contents 

TTM — Wide or narrow listing format 




/SHOW[:type] controls FORTRAN listing format; type can be 
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FORMAT r /[NO]QUERY “I @ device 

/SINGLEDENSITY 

/VERIFY[:ONLY] 

/PATTERN :value 
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/PATTERN[:value] specifies which of the following bit patterns to use for verification: 


c c\j o lO rj- Tt 

<D O C\J ID CO 

e 1- Tt ID in CD 

co c\j o in Ta- tj- 

Q. O T- i— T- i— 


9> O © O O O 

o o o o o 

CO ^ CM ^ o o 

> C\J 


c O 1- CD CM in 

fc O 1- CM in CM 

ffl O ▼" t- CM l/) 

c o i- co in cm 

CO O 1- CD CM in 

Q- O i— O 


-=? CM Tf O O O 
g ^ CM M- 


~o 

O) C 

£ 2 

*2 E 

<3 £ 
E o 
o ° 

5 £ 
o> I P 
5 £ |j 

i„ s § 

O CO ~ ^ 
CD t > j- 

O . o 
v2 ‘tr cd 
% -O 

■° co ^ o 

C C o © 
° ® £ § 
K*§ 
§ * I z 

° .E « o 

£ S I ® 

^ *s O E 

10 CO © O 

czr ^ ^ > 
o 73 © «- 
c CO co o 

S | =1 2 

SO 9 f 




>■ Z z 

CC LU o 

LU Q 
DU)>- 

2^b 

mi 


37 




CO 

o 

0 

Cl 

(0 

0 


do) 


CO 

DC 

LU 

m 


O LU 
CL CO 

LU Z 

o < 
QQ 
I 


o 

0 

8 8 

0 := 


< o 


Q OC 

— LU 
□ 
< 
X W 


HI 


y © O "J o 

5 *= —i m —i 
i ^_i O—l 

^ I- < 


O CO 




O) 

o| 

Z> Q 
DQ DC 
LU O 
Q O 

Z LU 

Q 


oT co 

|o 

■K I— 

o 5 

X I- 

c£ c£ 


Q. 

|l 

Is 


CO 
CO O 
DC Z 

gz 

I| 


z 

< 

DC 

I- 

DC 

o 


38 







The FORTRAN command runs the FORTRAN compiler. 
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2 or MAP — storage map and diagnostics 

3 — diagnostics, source program, and storage map 

4 or COD — generated code and diagnostics 
7 or ALL — all of the above 
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FRUN (sp) filespec 1“ /BUFFER:n 

/NAME.name 

/PAUSE 
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GET de) filespec 

The GET command loads a memory image file into memory. 







The GT command enables or disables the VT-11 or VS60 display hardware. 
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The HELP command lists information about various topics and options. 
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IITIALIZE r / /BACKUP 
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The INITIALIZE command writes an empty directory on a volume. 

/BACKUP initializes a volume for use with BUP 

/BADBLOCKS[:RET] scans the volume for bad blocks and creates FILE.BAD directory entries; 
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The INSTALL command enters device names in the monitor system tables. 
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The LIBRARY command creates and updates .OBJ and macro libraries. 
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The LINK command combines .OBJ modules into a program that can be run. 
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/BOTTOM, /TOP, /LIMIT, and /LDA 




/GLOBAL produces cross-reference of all global symbols in the load map 

/INCLUDE asks for globals to be included from libraries 

/LDA links file in LDA format; invalid with /FOREGROUND and /XM 

/LIBRARY:filespec same as /LINKLIBRARY 

/LIMIT:n specifies high limit for XM virtual .SETTOP; valid only with /XM; n is K-word 
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LOAD (sp) device!=jobname][,...device! = jobname]] 
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The MACRO command runs the MACRO assembler. 
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LSB — Defines local symbol block 
MCL — Enables or disables automatic .MCALL 
PNC — Enables or disables binary output 
REG — Defines default register mnemonics 




/ENABLE:type[...:type] specifies .ENABL directives; types are listed under /DISABLE 

/LIBRARY identifies a macro library file 

/LIST[:filespec] outputs program listing to the line printer or to filespec 
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SYM — Symbol table 

TOC — Table of contents 

TTM — Wide or narrow listing format 




MAKE dE) filespec 

The MAKE command is available only under the FB amd XM monitors. It is equivalent to: 
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/[N0]WRITE [does not] permit writing to the logical disk unit 




The MUNG command is available only under the FB and XM monitors. It is equivalent to: 
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The PRINT command prints the contents of one or more files on the line printer. 
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/SINCE[:date] prints files created on or after date 

/WAIT invalid when QUEUE is running; waits for volume to be mounted before 

executing the command 
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The R command runs programs from the system volume. 
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The REENTER command starts a program at its reentry address. 





REMOVE © device[,...device] 
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/[N0]L0G [does not] list files renamed on the console terminal 

/NEWFILES renames only files with the current system date 

/[N0]PR0TECTI0N [does not] mark a file as protected 







/QUERY asks for confirmation before renaming a file 

/[NO]REPLACE [does not] replace an existing file having the same name 

/SETDATE[:date] assigns date to all renamed files 
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The RESET command initializes background system tables. 




The RESUME continues execution of a foreground or system job after a SUSPEND command. 
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device. 





SAVE (sp) filespec [(sp) parameters] 
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The SET command changes characteristics of device handlers and the values of some system parameters. 
Refer to the list of SET commands at the end of this section for a complete list of all SET options. 
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ALL includes the CONFIGURATION, DEVICES, device assignments (SHOW 

with no arguments) JOBS, TERMINALS, MEMORY, and SUBSET options 
CONFIGURATION lists the monitor version, patch level, monitor SET options in effect, hard- 
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The SQUEEZE command consolidates all unused blocks and directory entries on a volume. 
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SRUN m filespec [~ /BUFFER:n 

/LEVELn 

/NAME:logical-jobname 
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The START command begins execution of a program at the specified address. 
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The SUSPEND command temporarily stops execution of a foreground or system job. 






TECO filespec 
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The TIME command displays or sets the system time. 





(0 

c 

E 

0 

0 

O 


O 

O 


0 
o 
0 
Q. 
< t ) 
0 




0 

I 2 

J_ 0 

LU ‘D 

gsr 

£o 

LU ? 
CD CO 


© CO 
0 LU 

T? =d 

LU > 
I- ^ 
< LU 
Q Z 


CO UJ I g ^ 
LU I - GC O C 


o 
o o 


^ 2.0 j 


0 

c 

o 

o 

0 


0 

E 

E 

o 

o 

LU 

CL¬ 


UJ 

Q_ 


"D 

c 

0 

■D 

C 

3 

O 



C\J 

CO 


CM 

E 

cd 2 

-g 0 

« -O 
© c 


0 

0 

O) 

0 

0 

0 

0 

E 

0 

0 


.Q 

C 

O 

UJ 

C 

0 


-o 

0 

_0 

"O 

0 

c 

0 


0 

0 

0 

Q. 

C 


0 

0 


O 


O 

0 

O 

0 

o 

0 

0 

H 

0 

E 

0 

_0 

0 

CL 

p 

0 

c 

o 

0 

-C 

>N 

O 



p 

o 

C 

o 

r- 

c 

o 

0 

0 



T 3 

0 

CL 

> 0 
© 1 
* E 
0 © 
x: 0 

~ >s 

0 w 
0 ~ 

s i 

5S 

0 _£Z 
0 ~ 

E £ 

gf 


0 >s © 

0 0 0 ^ ^5 

c c c .© 9 - c 

•c -c -c 0 .0 — 

CL CL CL -Q “O 


0 


0 0 0 

■? © ■? 

E o E 

CL S CL 



72 


/QUERY asks for confirmation before printing file 

/SINCE[:date] prints only files created on or after date 

/WAIT waits for volume to be mounted before executing the command 
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The UNPROTECT command removes protection from files so that they can be deleted. 
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SET Commands 


Both the monitor and the device handlers have SET commands. 
Most of the device handler SET commands affect only the copy 
of the handler on SY:. Any copy of the handler in memory is not 
affected. The few exceptions are marked with an asterisk (*) or a 
plus (-i-). An asterisk indicates that any memory-resident copy of 
the handler and the disk-resident copy of the handler are 
changed. A plus indicates that only the memory-resident copy of 
the handler is changed. 

The monitor SET commands, such as SET USR NOSWAP, set 
or clear status words in the resident monitor. 


Device 

or 



Item 

Condition 

Effect 

CR 

CODE=n 

Modifies the card reader handler 
to use either DEC 026 or DEC 
029 card codes 


CRLF 

Appends a carriage 

return/linefeed to each card im¬ 
age 


NOCRLF 

Transfers each card image with¬ 
out appending a carriage 
return/linefeed 


HANG 

Waits for user correction if reader 
is not ready 


NOHANG 

Generates an immediate error if 
reader is not ready 


IMAGE 

Reads each card as a 12-bit bi¬ 
nary number 


NOIMAGE 

Translates card codes to ASCII, 
as set by the CODE option 


TRIM 

Removes trailing blanks 


NOTRIM 

Transfers full 80 columns per 
card 
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DD 

CSR = n 

Uses n as the CSR address for 
the first DECtape II controller 


CSR 2 =n 

Uses n as the CSR address for 
the second DECtape II controller 


RETRY=n 

Sets the number of retries after 
an I/O error 


SUCCES 

Logs successful I/O transfers as 
well as errors when running the 
error logger 


NOSUCCES 

Logs only I/O errors 


VECTOR=n 

Uses n as the vector address for 
the first DECtape II controller 


VEC 2 =n 

Uses n as the vector address for 
the second DECtape II controller 

DL 

CSR = n 

Uses n as the CSR address for 
the DL handler 


RETRY = n 

Sets the number of retries after 
an I/O error 


SUCCES 

Logs successful I/O transfers as 
well as errors when running the 
error logger 


NOSUCCES 

Logs only I/O errors 


VECTOR=n 

Uses n as the vector address for 
the DL handler 

DM 

CSR = n 

Uses n as the CSR address for 
the DM handler 


RETRY = n 

Sets the number of retries after 
an I/O error 


SUCCES 

Logs successful I/O transfers as 
well as errors when running the 
error logger 


NOSUCCES 

Logs only I/O errors 


VECTOR=n 

Uses n as the vector address for 
the DM handler 

DUx 

CSR = n 

Uses n as the CSR address for 
the first port of the DU MSCP 
controller 
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DXx 


CSRm=n 

PART = n 
PORT = n 

RETRY = n 
SUCCES 

NOSUCCES 
UNIT = n 

VECTOR=n 

VECm = n 


CSR = n 
RETRY = n 

SUCCES 

NOSUCCES 
VECTOR=n 

* WRITE 

* NOWRITE 


Valid only if handler is assembled 
for multiple ports; uses n as the 
CSR address for DU port m ; m 
can be 2, 3, or 4 
Assigns DUx to MSCP partion n; 
initial n is 0 

Valid only if handler is assembled 
for multiple ports; assigns DUx to 
MSCP port n; initial n is 0 
Sets the number of retries after 
an I/O error 

Logs successful I/O transfers as 
well as errors when running the 
error logger 
Logs only I/O errors 
Assigns DUx to MSCP unit n\ ini¬ 
tial setting defines n equal to x 
Uses n as the vector address for 
the first port of the DU MSCP 
controller 

Valid only if handler is assembled 
for multiple ports; uses n as the 
vector address for port rrr, m can 
be 2, 3, or 4 

Uses n as the CSR address for 
the DX handler 

Sets the number of retries after 
an I/O error 

Logs successful I/O transfers as 

well as errors when running the 

error logger 

Logs only I/O errors 

Uses n as the vector address for 

the DX handler 

Write enables DX unit x 

Write locks DX unit x 
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DYx 


EDIT 


EL 


ERROR 


CSR = n 
RETRY = n 
SUCCES 

NOSUCCES 
VECTOR=n 

* WRITE 

* NOWRITE 


Uses n as the CSR address for 
the DY handler 

Sets the number of retries after 
an I/O error 

Logs successful I/O transfers as 

well as errors when running the 

error logger 

Logs only I/O errors 

Uses n as the vector address for 

the DY handler 

Write enables DY unit x 

Write locks DY unit x 


EDIT 

KED 

K52 

TECO 

+ LOG 
+ NOLOG 
+ PURGE 


Defines EDIT.SAV to be the de¬ 
fault text editor for the keyboard 
monitor EDIT command 
Defines KED.SAV to be the de¬ 
fault text editor; requires a VT100 
terminal 

Defines K52.SAV to be the de¬ 
fault text editor; requires a VT52 
terminal 

Defines TECO.SAV to be the de¬ 
fault text editor 

Turns on error logging in SJ moni¬ 
tor 

Turns off error logging in SJ moni¬ 
tor 

Clears internal error log buffer in 
SJ monitor 


WARNING Aborts indirect command files and 
KMON commands if warnings, er¬ 
rors, or severe or fatal errors oc¬ 
cur 

ERROR Aborts indirect command files and 

KMON commands if errors or se¬ 
vere or fatal errors occur 
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FATAL ) 
SEVERE j 

NONE 


EXIT SWAP 

NOSWAP 

KMON IND 

NOIND 


LDx * CLEAN 

* FREE 

* WRITE 

* NOWRITE 

LP CR 

NOCR 

CSR = n 


Aborts indirect command files and 
KMON commands if severe or fa¬ 
tal errors occur 

Allows indirect command files and 
KMON commands to continue, if 
possible, despite severe or fatal 
errors 

Saves running program in swap 
blocks when program exits so 
that it can be restarted with 
REENTER command 
Disables writing of program to 
swap blocks when program exits 

Causes indirect command files 
(@filespec syntax) to be inter¬ 
preted by IND.SAV 
Causes indirect command files to 
be interpreted by KMON. The 
syntax $@filespec forces NOIND 
interpretation even when SET 
IND is in effect 

Checks all logical disk assign¬ 
ments to make sure they are valid 
Deassigns logical disk unit x 
Write enables logical disk unit x 
Write locks logical disk unit x 

Passes carriage return characters 
(octal 15) to the line printer 
Does not pass carriage return 
characters to the line printer 
Uses n as the CSR address for 
the LP handler 
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LS 


CTRL 

NOCTRL 

FORM 

NOFORM 

FORMO 

NOFORMO 

HANG 

NOHANG 

LC 

NOLC 

LENGTH=n 
SKIP = n 

TAB 

NOTAB 

VECTOR=n 

WIDTH = n 


CR 

NOCR 


Passes ail characters, including 
non-printing control characters, to 
the line printer 

Ignores non-printing control char¬ 
acters 

Uses the formfeed character (oc¬ 
tal 14) to generate formfeeds 
Uses multiple linefeed characters 
to simulate formfeeds 
Issues a formfeed before printing 
block 0 

Does not issue a formfeed before 
printing block 0 

Waits for user correction when 
the line printer is not ready 
Generates an immediate error 
when the line printer is not ready 
Sends lowercase characters to 
the line printer 

Translates lowercase characters 
to uppercase before printing 
Defines length of page; initial 
value of n is 66 

Defines number of lines to skip at 
page break; use with SET LP NO¬ 
FORM 

Sends TAB characters (octal 11) 
to the line printer 
Simulates tabs with spaces 
Uses n as the vector address for 
the line printer 

Sets line width to n\ n can be 30 
to 255(decimal); initial value of n 
is 132 

Passes carriage return characters 
(octal 15) to the line printer 
Does not pass carriage return 
characters to the line printer 
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CSR = n 
CTRL 

NOCTRL 

FORM 

NOFORM 

FORMO 

NOFORMO 

HANG 

NOHANG 

LC 

NOLC 

LENGTH = n 
SKIP = n 

TAB 

NOTAB 

VECTOR=n 

WIDTH = n 


Uses n as the CSR address for 
the LS handler 

Passes all characters, including 
non-printing control characters, to 
the line printer 

Ignores non-printing control char¬ 
acters 

Uses the formfeed character (oc¬ 
tal 14) to generate formfeeds 
Uses multiple linefeed characters 
to simulate formfeeds 
Issues a formfeed before printing 
block 0 

Does not issue a formfeed before 
printing block 0 

Waits for user correction when 
the line printer is not ready 
Generates an immediate error 
when the line printer is not ready; 
requires device timeout support in 
the handler 

Sends lowercase characters to 
the line printer 

Translates lowercase characters 
to uppercase before printing 
Defines length of page; initial 
value of n is 66 

Defines number of lines to skip at 
page break; use with SET LS NO¬ 
FORM 

Sends TAB characters (octal 11) 
to the line printer 
Simulates tabs with spaces 
Uses n as the vector address for 
the LS handler 

Sets line width to n ; n can be 30 
to 255(decimal); initial value of n 
is 132 
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MM DEFALT = 9 

DENSE=n 

Sets defaults for 9-track magtape 
Sets density for 9-track magtape 
handler; n can be 800, 809, or 
1600 

ODDPAR 

Sets odd parity for 9-track mag¬ 
tape 

NOODDPAR 

Sets even parity for 9-track mag¬ 
tape 

MT DEFALT = n 

Sets defaults for 7- or 9-track 

DENSE=n 

magtape; n can be 7 or 9 

Sets density for 7- or 9-track mag¬ 
tape; n can be 200, 556, 800, 
807, or 809 

DUMP 

Writes bytes to 7-track magtape 
at 800 bbpi 

ODDPAR 

Sets odd parity for 7- or 9-track 
magtape 

NOODDPAR 

Sets even parity for 7- or 9-track 
magtape 

PDx * WRITE 

* NOWRITE 

Write enables PD unit x 

Write locks PD unit x 

RK CSR=n 

Uses n as the CSR address for 
the RK handler 

RETRY = n 

Sets the number of retries after 
an I/O error 

SUCCES 

Logs successful I/O transfers as 
well as errors when running the 
error logger 

NOSUCCES 
VECTOR=n 

Logs only I/O errors 

Uses n as the vector address of 
the RK handler 

SL ASK 

Automatically checks for type of 
terminal 

KMON 

Enables use of SL by KMON but 
not by user programs 
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LEARN 

Leaves help text on screen and 
scrolls input below it 

NOLEARN 

Does not keep help text on 
screen 

OFF 

Disables single-line editor 

ON 

Enables single-line editor for use 
both by KMON and by user pro¬ 
grams and loads the SL handler 

SYSGEN 

Configures the SL handler to 
match the current monitor’s SYS¬ 
GEN parameters 

TTYIN 

Enables single-line editing of 
.TTYIN input; if special made is 
set (bit 12 of the JSW) this com¬ 
mand has no effect 

NOTTYIN 

VT52 

VT62 

VT100 

VT101 

Disables single-line editing of 
.TTYIN input 

VT102 

Configures the SL handler to use 
the type of terminal you specify 

WIDTH = n 

Sets line width to n\ n can be 30 
to 132(decimal); initial value of n 
is 79 


termI 
TT / 

+ CONSOL = n Changes background console ter¬ 
minal to terminal defined as logi¬ 
cal terminal n\ requires multitermi¬ 
nal support 

+ CRLF Automatically inserts carriage 

return/linefeed when you attempt 
to type past the right margin 

+ NOCRLF No special action is taken at the 
right margin 


85 





+ FB 

+ NOFB 
+ FORM 

+ NOFORM 
+ HOLD 
+ NOHOLD 
+ PAGE 

+ NOPAGE 
+ QUIET 

+ NOQUIET 

+ SCOPE 

+ NOSCOPE 

+ TAB 
+ NOTAB 

+ WIDTH = n 


Treats (ctrl/f ktrl/b ) } and (Ctrl/x ) 
as program control characters 
Assigns no special meaning to 
(ctrl/f \ (ctrl/b ) ; and Cctrl/x ) 
Indicates that the console has 
hardware formfeed capability 
Simulates formfeeds with eight 
linefeeds 

Enables Hold Screen mode for 
VT50/VT52 

Disables Hold Screen mode for 
VT50/VT52 

Interprets (ctrl/s j as XOF and 
(ctrl/qJ as XON to stop and start 
terminal output, respectively 
Disables special handling of 
(crnTsl and (ctrlTqI 
Disables echoing of lines from in¬ 
direct command files 
Enables echoing of indirect com¬ 
mand file lines as they are pro¬ 
cessed 

Echoes RUBOUT characters as 
backspace/space/backspace 
Echoes RUBOUT as backslash 
followed by the character(s) de¬ 
leted 

Indicates that the console termi¬ 
nal has hardware tab stops 
Simulates tab stops every eight 
positions 

Sets the terminal width to n\n can 
be 30 to 255(decimal); initial 
value of n is 72 


USR SWAP Allows the background job to 

swap the USR 

NOSWAP Locks the USR in memory so that 

it cannot be swapped 
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VM BASE-n 


WILD EXPLICIT 

IMPLICIT 


VM handler uses only memory 
above n\ value of n is physical ad¬ 
dress divided by 10O(octal) 

The system recognizes file speci¬ 
fications exactly as typed 
The system fills in missing fields 
in file specifications with wild¬ 
cards (asterisks) 
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RT-11 Utility Program Options and 
ODT Command Summary 

RT-11 utilities use the Command String Interpreter (CSI) to pro¬ 
cess the command lines typed to them. 

CSI Command String Format 

output-filespecs/options = input-filespecs/options 

Syntax 

output-filespec (up to three files) 
dev:filnam.typ[n],.. .dev:filnam.typ[n] 
input-filespec (up to six files) 
dev:filnam.typ,...dev:filnam.typ 
/option 

/x:oval or /x:dval. 


Mnemonic 

Meaning 

dev: 

1 - to 3-character device name 

filnam 

1 - to 6-character file name 

typ 

0- to 3-character file type 

[n] 

length of output file; brackets are part of syntax 

/X 

option character 

oval 

optional octal argument or Radix-50 3-charac- 
ter argument 

dval. 

optional decimal argument; indicated by deci¬ 
mal point 

= 

separates output and input filespecs 


Some utility programs, such as BINCOM, have particular mean¬ 
ings assigned to particular files in the CSI command string. In 
these cases, the syntax of the utility’s command line is shown in 
detail. 
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BINCOM (Binary Compare Program) 

Syntax 
.R BINCOM 

*[listfile][,SIPPfile] = oldfile,newfile[/options] 


Options 

/B 

/D 

/E:n 

/H 

/O 

Compares bytes instead of words 

Compares two entire volumes 

Ends comparison at block n f** 

Prints help information on terminal 

Creates a differences listing file or SIPP com¬ 
mand file even if no differences between the 

/Q 

/S:n 

input files are found 

Suppresses terminal output of differences 

Starts comparison at block n 
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BUP (Backup Utility Program) 


Options 

/I 

Backs up a large volume on multiple smaller 
volumes 

/L 

/X 

Lists directory of a backup volume 

Restores a large file or, with /I, a large volume 
from multiple backup volumes 

fZ 

no option 

Initializes a volume for backup 

Backs up a large file on multiple smaller vol¬ 
umes 
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DIR (Directory Listing Program) 


Options 

/A 

Lists directory alphabetically 

/B 

Includes starting block numbers in directory list¬ 

/C:n 

ing 

Lists directory in n columns; n can be 1 to 9 

/D[:date] 

Includes only files with date 

/E 

Lists entire directory, including unused spaces 

/F 

Lists short format directory in five columns 

/G 

Lists directory entry of specified file and all sub¬ 

/J[:date] 

sequent directory entries 

Lists files created on or after date 

/K[:date] 

Lists files created before date 

/L 

Lists volume directory in order of entry 

/M 

Lists unused areas 

/N 

Lists directory summary 

/O 

Gives sizes and block numbers in octal 

/P 

Lists all files except those you specify 

/Q 

Lists deleted files 

/R 

Sorts directory in reverse order; use with /S 

/S[:xxx] 

Sorts directory listing; xxx can be DAT, NAM, 

/T 

POS, SIZ, or TYP 

Lists only protected files 

/U 

Lists only unprotected files 

/V[:ONL] 

Includes volume ID and owner name as part of 

directory listing; with ONL, lists only ID and 
name 
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DUMP (File Dump Program) 


Options 

/B 

Outputs octal bytes 

/E:n 

Ends output at block n 

/G 

Ignores input errors 

/N 

Suppresses ASCII output 

/0:n 

Outputs only block n 

/S:n 

Starts output at block n 

FT 

Defines a magtape as non-RT-11 file struc¬ 
tured 

/W 

Outputs octal words 

/X 

Outputs Radix-50 characters 


93 




DUP (Device Utility Program) 


Options 

/B[:RET] 

Writes FILE.BAD entries over bad blocks; use 
with /Z; with RET, retains FILE.BAD entries cre¬ 

/C 

/D 

/E:n 

/F 

ated by previous initialization 

Creates a file; use with /G:n 

Restores previously initialized volume 

Specifies last block number; use with /I or /K 
Prints names of files with bad blocks; use with 
/K 

/G:n 

Specifies starting block number; use with /C, /I, 
or /K 

/H 

/I 

/K 

/N:n 

Verifies after copying; use with /I 

Copies image of one volume to another 

Scans a volume for bad blocks 

Defines number of directory segments; use with 
/Z; n can be 1 to 37(octal) 

O 0 

Boots a volume or file 

Boots a volume that is not RT V4 or later; use 
with /O 

/R[:RET] 

Scans volume for bad blocks and creates a 
block replacement table; with RET, retains pre¬ 
vious table 

IS 

/T:n 

Consolidates free space on a volume 

Extends a file by n blocks; n free blocks must 
follow the file 

/U[:dev] 

Writes bootstrap into blocks 0, 2 through 5 of a 
volume; dev is the target device name 

A/[:ONL] 

Prints user ID and owner name; use with TZ to 
write new directory, ID, and name on volume; 
with ONL, writes only a new ID and name 

/W 

Waits for volume to be mounted before execut¬ 

/X 

ing the command 

Prevents automatic reboot after using /S on 
system device 

/Y 

/Z[:n] 

Suppresses query messages 

Initializes device directory; n is the number of 
extra words in each directory entry 
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ERROUT (Error Log Report Writer) 

Options 

/A Prints report on each error and a summary re¬ 

port on all errors and I/O transfers 
/F:date Prints report of all errors that occurred on or 

after the date you specify 
/S Prints summary report only 

/T:date Prints report of all errors that occurred before 

the date you specify 
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FILEX (File Exchange Program) 

Options 

/A Transfers ASCII files character-by-character, 

deleting, nulls and rubouts; Cctrl/z j is interpreted 
as EOF 

/D Deletes a file; valid for DOS/BATCH, RSTS 

DECtape, interchange diskette 
/F Lists short directory 

/I Transfers in image mode 

/L Lists full directory 

/P Transfers in packed image mode 

/S Indicates volume is DOS/BATCH or RSTS for¬ 

mat 

/T Indicates volume is DECsystem-10 DECtape 

/U[:n] Indicates volume is interchange diskette; n de¬ 

fines size of output record; default n is 80 
A/[:ONL] Writes a volume identification on interchange 

diskette; use with /U/Z; with ONL, writes only 
volume ID and keeps old directory 
A N Waits for volume to be mounted before execut¬ 

ing the command 

/Y Suppresses query messages 

/Z Initializes device directory; valid for 

DOS/BATCH, RSTS DECtape, interchange 
diskette 
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FORMAT (Volume Formatting Program) 


FORMAT 

disks. 

Options 

/P[:n] 


/S 

A/[:ONL] 

/W 

/Y 

no option 


can format RK05, RX01, RX02, and RK06-RK07 


Defines patterns to be used during verification 
pass. 


n 

pattern 

n 

pattern 

1 

000000 

100 

021042 

2 

111111 

200 

104210 

4 

163126 

400 

155555 

10 

125252 

1000 

145454 

20 

052525 

2000 

146314 

40 

007417 




Formats diskettes in single-density format 
Formats, then verifies volume; with ONL, veri¬ 
fies without formatting 

Waits for volume to be mounted before execut¬ 
ing the command 
Suppresses query messages 
Formats without verification, assumes diskettes 
are double-density 
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IND (Indirect Command File Processor) 

Directive 

Label Definition _ 

.label: 

Assigns the name represented by label to a line 
in the control file so that the line can be refer¬ 
enced. 

Symbol Definition _ 

.ASK [def:time] symbol prompt 

Defines or redefines a logical symbol and as¬ 
signs the symbol a logical (true or false) value 
based on a response to a prompt. 

.ASKN [low:high:def:time] symbol prompt 

Defines or redefines a numeric symbol and as¬ 
signs it a numeric value based on a response to 
a prompt. 

.ASKS [low:high:“def”:time] symbol prompt 

Defines or redefines a string symbol and as¬ 
signs it a string value based on a response to a 
prompt. 

.DUMP symboltable 

Displays local, global, and special symbol defi¬ 
nitions. 

.ERASE LOCAL [symbolname] 

.ERASE GLOBAL [symbolname] 

Deletes local or global symbol definitions. 
.PARSE string “control-string” syml sym2 ....symn 

Breaks a string into substrings, which IND 
stores in string symbols. 

.SETD numericsymbol 
.SETO numericsymbol 

Redefines a numeric symbol to a decimal 
(.SETD) or octal (.SETO) radix. 

.SETL logicalsymbol logicalexpression 

Defines or redefines a logical symbol and as¬ 
signs it a logical value. 
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.SETN numericalsymbol numericalexpression 

Defines or redefines a numeric symbol and as¬ 
signs it a numeric value. 

.SETS stringsymbol stringexpression 

Defines or redefines a string symbol and as¬ 
signs it a string value. 

.SETT logicalsymbol 
.SETT [mask] numericsymbol 
.SETF logicalsymbol 
.SETF [mask] numericsymbol 

Defines or redefines a logical symbol or rede¬ 
fines bits within a numeric symbol, and assigns 
the symbol or bits a true or false value. 

.VOL stringsymbol device 

Assigns the volume identification of a volume to 
a string symbol. 

File Access_ 

.CHAIN filespec[/options] 

Closes the current control file, opens another 
control file, and resumes execution. 

.CLOSE [#n] [filespec] 

Closes an output data file. 

.DATA [#n] text-string 

Specifies a single line of data to be sent to an 
output data file. 

.OPEN [#n] filespec 

Creates an output data file. If the file you spec¬ 
ify with .OPEN already exists, .OPEN creates a 
new tentative file with the same name. If you 
subsequently use the .CLOSE directive, 
.CLOSE will delete the old file and make the 
new file permanent. Use the .OPEN directive 
only when you wish to write to a file. 

.OPENA [#n] filespec 

Opens an existing file and appends subsequent 
data to it. If the file you specify does not already 
exist, .OPENA creates a new file. Use this di¬ 
rective only when you wish to write to a file. 
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.OPENR [#n] filespec 

Opens an existing file for use with the .READ 
directive. Use this directive only when you wish 
to read from a file. 

.PURGE [#n] 

Deactivates an output file, resulting in no 
changes to already existing files. 

.READ [#n] stringsymbol 

Reads the next record from a file into a string 
variable. The file must have been previously 
opened with .OPENR. 

.TESTFILE filespec 

Determines whether or not a file exists. 


.BEGIN 

.END 

.EXIT [value] 


.GOSUB label 
.GOTO label 
.ONERR label 

.RETURN 


Logical Control 

Marks the beginning of a Begin-End block. 

Marks the end of a Begin-End block. 

Terminates processing of either a Begin-End 
block or the current control file and returns con¬ 
trol to the previous level; can also assign a 
value to the numeric symbol <EXSTAT>. 

Branches to a subroutine within the control file. 

Branches to another location in the control file. 

Upon detecting an error, branches to another 
location in the control file. 

Returns control from a subroutine to the line 
immediately following that subroutine’s call. 


.STOP 


Terminates control file processing. 





Logical Tests 

.IF symbol operator expression action 

Determines whether or not a symbol satisfies 
one of several possible conditions. 

.IFDF symbol action 
.IFNDF symbol action 

Determines whether or not a symbol is defined. 
.IFENABLED opmode action 
.IFDISABLED opmode action 

Determines whether an operating mode is en¬ 
abled or disabled. 

. I FLO A device action 
.IFNLOA device action 

Determines whether or not a device handler 
has been loaded. 

.IFT logicalsymbol action 

.IFT [mask] numericsymbol action 

.IFF logicalsymbol action 

.IFF [mask] numericsymbol action 

Determines whether a logical symbol is true or 
false, or tests specific bits in a numeric symbol. 
.TESTDEVICE devicename[:] 

Returns information about a device in the string 
<EXSTRI>. 

.TEST symbol 

.TEST stringsymbol matchstring 

Tests a symbol or string. 

Execution Control 

.DELAY time 

Delays control file processing for a specified 
period of time. 
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Disable/Enable Operating Modes_ 

.DISABLE model [,mode2,mode3...] 

.ENABLE model [,mode2,mode3...] 

Disables or enables the operating modes, 
which are: 

DATA LOWERCASE SUBSTITUTION 
DCL MCR SUFFIX 

DELETE OCTAL TIMEOUT 

ESCAPE PREFIX TRACE 

GLOBAL QUIET 

Increment/Decrement Numeric Symbols_ 

.DEC numericsymbol 

Subtracts 1 from the value of a numeric sym¬ 
bol. 

.INC numericsymbol 

Adds 1 to the value of a numeric symbol. 


Options 


/D 

Deletes control file after processing 

/N 

Suppresses execution of KMON commands 
within a control file 

/T 

Lists each IND command line as it is executed 

/Q 

Suppresses display of keyboard commands 
and responses 
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KED (Keypad Editor) 

Options 

/A:n Allocates n blocks for output file 

/C Creates a new file 

/I Inspects input file, does not allow changes 
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LD.SYS (Logical Disk Handler) 


LD.SYS operates in two ways: either it can be used by programs 
as a handler to access logical disks, or it can be run as a pro¬ 
gram to initialize logical disk parameters. 


Options 

/A:ddd 

Assigns logical name ddd to a logical disk unit; 
use with /L:n 

/C 

Verifies all logical disk assignments; must be 
alone on command line 

/L:n 

Assigns or deassigns logical disk unit n 

/R:n 

Write locks logical disk unit n 

/W:n 

Write enables logical disk unit n 
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LIBR (Librarian) 

Syntax 
.R LIBR 

*[libraryfile][,listfile] = inputfiles[/options] 


Options 

/A 

Includes in library directory all global symbols 
including absolute global symbols 

/C 

/D 

/E 

Allows multiple input lines 

Deletes a module from a library file 

Extracts a module from a library and stores it as 
a .OBJ file 

/G 

/M:n 

Deletes a global symbol from a library directory 
Creates a macro library from an ASCII input file 
and allocates n blocks for the macro name di¬ 

/N 

/P 

/R 

/U 

rectory 

Includes module names in library directory 
Includes psect names in library directory 
Replaces modules in a library file 

Updates (inserts and replaces) modules in a li¬ 
brary file 

/W 

Produces a wide (132 column) library directory 
listing 

/X 

// 

Creates a library with multiple global definitions 
Allows multiple input lines until next occurrence 
of// 

no option 

Assumes module insertion 
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LINK (Linker) 

Syntax 
.R LINK 

*[binfile][,mapfile][,stbfile] = objfiles[/options] 

Options 

/A Lists global symbols in alphabetical order 

/B:n Sets bottom address of program to n\ invalid 

with /H and /R 

/C Continues input on new line; do not use with // 

/D Allows duplicate library subroutines 

/E:n Extends root program segment to specific value 

/F Uses default FORTRAN library FORLIB.OBJ 

when linking 

/G Increases size of linker’s library directory buffer 

/H:n Specifies highest address to be used by relo¬ 

catable code; invalid with /B, /Q, /R, /Y 
/I Extracts specified global symbols from a library 

/K:n Inserts value of n into word 56 of block 0 as 

virtual .SETTOP high limit; n can be 1 to 
32(decimal); valid only with /V 

/L Produces output file in LDA format; invalid with 

/R, /V 

/M[:n] Defines stack address 

/N Produces global cross-reference listing as part 

of load map 

/0:n Defines overlay structure; invalid with /L 

/P:n Changes amount of space linker uses for li¬ 

brary routines list; default is 170 
/Q Specifies start addresses of up to eight root 

program sections; invalid with /R, /H 
/R[:n] Produces output in .REL format; n is the stack 

size; invalid with /B, /H, /K, /L, Q 


106 





^ >< 


IS Allows maximum memory space for linker sym¬ 

bol table 

/T[:n] Defines transfer address 

/U:n Rounds up a program section size; n must be a 

power of 2 

A/ Enables special XM monitor .SETTOP and 

.LIMIT features; invalid with /L 

/W Produces a wide load map listing (132 col¬ 

umns) 

Does not output bitmap if code is below 400 
:n Starts a program section on address boundary 

n\ invalid with /H 

/Z:n Sets unused locations to n 

// Allows multiple input lines; use on first and last 

lines of input 
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MACRO (Macro Assembler) 

Syntax 
.R MACRO 

*[objfile][,listfile][,creffile] = inputfiles[/options] 

Temporary files for MACRO and CREF are normally assigned to 
DK. Assign the logical name WF to reassign MACRO’S work file; 
assign the logical name CF to reassign CREF’s temporary file. 

Options 

/C[:arg] Generates cross-reference table; arg can be 

C — Control and program sections 
E — Errors 
M — Macro names 
P — Permanent symbols 
R — Registers 
S — User-defined symbols 
no argument — equivalent to /C:E:M:S 
/D:arg Specifies .DSABL directives; arg can be 

ABS — Produces absolute binary output 
AMA — Assembles all relative addresses as 
absolute addresses 

CDR —Treats source columns beyond col¬ 
umn 72 as comments 

DBG — Outputs ISD records as part of .OBJ 
file 

FPT — Floating-point truncation 

GBL — Treats undefined symbols as globals 

LC — Accepts lowercase ASCII input 

LSB — Local symbol block 

MCL — Automatic .MCALL 

PNC — Binary output 

REG — Defines default register mnemonics 
/E:arg Specifies .ENABL directives; refer to values for 

arg under /D 
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/L:arg 


/M 

/N:arg 


Enables listing directives; arg can be 
BEX — Binary expansions of ASCII text 
BIN — Generated binary code 

CND — Unsatisfied conditionals and all .IF 

and .ENDC statements 
COM — Comments 

LD — Listing directives having no argu¬ 

ments 

LOC — Location counter 
MC — Macro calls and repeat range ex¬ 
pansions 

MD — Macro definitions and repeat range 
expansions 

ME — Macro expansions 
MEB — Macro expansion binary code 
SEQ — Line numbers 
SRC — Source code 
SYM — Symbol table 
TOC — Table of contents 
TTM — Listing output format in 80-column 
format; default is 132-column format 
Macro library input file 

Disables listing directives; refer to values for 
arg under /L 
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ODT/VDT (Octal Debugger) 

Commands 

® Closes open location and accepts next com¬ 

mand 

© Closes current location and opens next se¬ 

quential location 
Opens previous location 
Indexes contents of opened location by PC and 
opens resulting location 

> Uses contents of opened location as relative 

branch and opens that location 

< Returns to sequence prior to >, or _ and 

opens next location 

@ Uses contents of opened location as absolute 

address and opens that location 
r/ Opens word at location r 

/ Reopens last opened location 

r\ Opens byte at location r 

\ Reopens last opened location as byte 

I Prints address of opened location relative to the 

closest relocation register 

nl Prints address of opened location relative to re¬ 

location register n 

$n/ Opens general register n 

$B/ Opens first word of breakpoint table 

$C/ Opens constant register 

$F/ Opens format register 

$M/ Opens first mask register 

$P/ Opens priority register 

$R/ Opens first relocation register 

$S/ Opens status register 

r;nA Prints n bytes of ASCII starting at location r, 

then allows n bytes of input from the terminal 
;B Removes all breakpoints 

r;B Sets next free breakpoint at location r 

r;nB Sets breakpoint n at location r 

;nB Removes breakpoint n 

n;C Stores n in constant register 
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x P. 


r;E Searches for instructions that reference effec¬ 

tive address r 

;F Fills memory with the contents of the constant 

register 

r;G Starts execution of program at location r 

;l Fills memory bytes with low 8 bits of the con¬ 

stant register 

r;0 Calculates offset from current location to loca¬ 

tion r 

;P Execution proceeds from breakpoint 

n;P Execution proceeds from breakpoint; stops af¬ 

ter encountering the breakpoint n times 
;R Sets all relocation registers to 177777 

;nR Sets relocation register n to 177777 

m;nR Sets relocation register n to value m ; default n 

is 0 

R Subtracts contents of closest relocation register 

less than or equal to the contents of the current 
location from the contents of the location, and 
prints result 

nR Subtracts contents of relocation register n from 

contents of current location and prints result 
! Calculates address of the current location rela¬ 

tive to the closest relocation register less than 
or equal to the address of the current location, 
and prints result 

n! Calculates address of the current location rela¬ 

tive to relocation register n, and prints result 
;S Disables single-step mode 

;nS Enables single-step mode; n can be any integer 

W Searches for words matching value n 

Prints contents of opened location as Ra¬ 
dix-50; accepts three Radix-50 characters as 
input 
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PAT (Object Module Patch Program) 

Options 

/C[:n] Calculates [or verifies] module checksum 
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PIP (Peripheral Interchange Program) 


Options 

/A 

/B 

/C[:date] 

/D 

/E 

Copies files in ASCII mode 

Copies files in formatted binary mode 

Includes only files with date 

Deletes files 

Waits for volume to be mounted before execut¬ 

/F 

/G 

/H 

ing the command 

Marks output files as protected 

Ignores any input errors 

Copies files from one large volume to several 
small volumes 

/l[:date] 

/J[:date] 

/K:n 

Copies only files created on or after date 
Copies files created before date 

Transfers n copies of the output files to a se¬ 
quential device, such as LP:, PC:, or TT: 

/M:n 

Controls positioning and rewinding of magtape; 
refer to PIP — Use of /M:n, below 

/N 

Does not copy or rename a file if a file of the 
same name exists on the output device 

/O 

Deletes a file on the output device before copy¬ 
ing, if a file of a given name already exists 

/P 

/Q 

/R 

/S 

/T[:date] 

/U 

/V 

/W 

/X 

Copies or deletes all files not specified 

Queries before performing operation 

Renames input filename to output filename 
Copies files one block at a time 

Puts date on all files copied or renamed 

Copies and concatenates specified files 

Verifies output file; do not use with /A or /B 
Logs operations on console 

Prints informational rather than fatal messages 
for files not found, and processes all others 

/Y 

/Z 

no option 

Includes .SYS files in operation 

Removes protection from output files 

Copies files in Image mode 


Options /D, /F, /K, N, /O, /R, /T, /Z are invalid or restricted with 
magtape. 
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PIP — Use of /M:n 


Effect when reading from magtapes 

n = 0 The magtape rewinds and PIP searches for the 

file. If more than one name is given, PIP 
rewinds for each file. If a wildcard is used, PIP 
rewinds once and then copies all matching files 
as they are encountered. 

n = + n PIP goes to file with sequence number n. If the 

file at that position matches specified name, the 
file is copied; otherwise PIP returns file not 
found error. If a wildcard is used, PIP begins 
the search at file n. 

n = -1 PIP begins the search at current position with¬ 

out rewinding. 

Effect when writing to magtapes 

n = 0 The tape rewinds before each file is copied and 

PIP searches for a duplicate file name. If a file 
of the same name is found, PIP prints a warn¬ 
ing and does not copy the file. Otherwise, the 
file is written at LEOT. 

n = +n PIP goes to file sequence number n and enters 

specified file. If LEOT is encountered before file 
n, an error is printed. If more than one file name 
is specified or a wildcard is used, the tape does 
not rewind and PIP does not check for dupli¬ 
cate names. 

n = -1 PIP goes to LEOT and enters specified file 

without checking for duplicate names. 

n = -2 The tape rewinds before each copy operation. 

PIP enters the file at LEOT or at the occurrence 
of a duplicate file name. 
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QUEMAN (Queue Manager) 

Options 

/A Halts QUEUE 

/C[:date] Prints only files created on date 

/D Deletes files after printing 

/H:n Prints n banner pages 

/l[:date] Prints only files created on or after date 

/J[:date] Prints files created before date 

/K:n Prints n copies of a file 

/L Lists current contents of the queue 

/M Deletes a file from the queue 

/P Sets QUEUE defaults for /H and deletion of 

work file 

/Q Asks for confirmation before printing 

/R Resumes or restarts current job 

/S Suspends current job; resume with /R 

/W Logs all files printed 

/X Prints error messages for files not found and 

processes all others 

// Allows multiple input command lines 
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RESORC (Resource Program) 

Options 

/A Combines all options except /Z 

/C Identifies system device and lists monitor SET 

options in effect 

/D Lists available device handlers and their vec¬ 

tors 

/H Lists system hardware configuration 

/J Lists currently loaded jobs 

/L Lists device assignments 

/M Lists monitor type, version number, and patch 

level 

/O Lists special features included by SYSGEN 

/S Lists disk subsetting in effect 

/T Lists status and options in effect for active ter¬ 

minals on a multiterminal system 
/X Lists organization of physical memory 

/Z Combines /C, /H, /J, /M, /O 
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SIPP (Save Image Patch Program) 

Syntax 
.R SIPP 

*[commandfile] = inputfilef/options] 


Options 

/A 

Prevents automatic update of location 50, win¬ 
dow definition block, overlay handler, or overlay 
tables 

/C 

/D 

/L 

Asks for checksum at completion of the patch 
Prints checksum at completion of the patch 
Creates command file but does not modify the 
input file 

Commands 

ffl 

Closes current location, opens and displays 
next location 

© 

Closes current location, opens and displays 
next location 

n® 

Deposits value n in current location, closes cur¬ 
rent location, opens and displays next location 

/ 

/® 

\® 

\ 

A ® 

Advances in word mode 

Reopens current location as a word 

Reopens current location as a byte 

Advances in byte mode 

Closes current location, opens and displays 
previous location 

n A ® 

Deposits value n in current location, closes cur¬ 
rent location, opens and displays previous loca¬ 
tion 

;A 

;0 

;Ax 

Interprets location contents as ASCII 

Gives values in octal, accepts input in octal 
Deposits ASCII character x in low byte of cur¬ 
rent location, opens and displays high byte in 
octal, accepts further input in ASCII 
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;R Interprets location contents as Radix-50 char¬ 

acters 

;Ryyy Deposits Radix-50 characters yyy in current lo¬ 

cation, closes current location, opens next loca¬ 
tion and gives value in octal, accepts further 
Radix-50 character input 

;S Prompts for value for which to search 

;V Prints all previously entered modifications 

Ktrl/y ) Prompts for checksum, if /C used, and installs 

patch 

(ctrl iz ) Backs up to previous SIPP prompt 
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SLP (Source Language Patch Program) 

Syntax 

.R 

*[patchedfile][,listfile] = inputfile[,commandfile][/options] 

Options 

/A Disables audit trail generation 

/B Uses spaces instead of tabs to position audit 

trail text 

/C Computes checksum for file 

/C:n Validates checksum for file 

/D Creates a double-spaced listing 

/L:n Defines maximum length of a source line, in 

characters 

/N Suppresses creation of backup file 

/P:n Starts audit trail in column n 

/S:n Defines length of audit trail; maximum value for 

n is 16(decimal) 

fT Retains trailing tabs and blanks in updated file 

Command File Operators 

Indicates start of an update 
\ Disables audit trail 

% Enables audit trail 

/ Indicates the end of an update or series of up¬ 

dates 

// Separates concatenated SLP command files 

< Indicates that the next character should be 

taken as source input, not interpreted as a 
command; use in front of _, \, %, /, and < when 
they must be inserted in a file 
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SRCCOM (Source Compare Program) 


Syntax 
.R SRCCOM 

*[listfile][,SLPfile] = oldfile,newfile[/options] 


Options 

/A 

/B 

/C 

/D 

Specifies audit trail for SLP command file 
Compares blank lines 

Ignores comments and spacing 

Copies newfile to listfile and inserts change 
bars and bullets at left margin of listfile to mark 
differences 

/F 

/L:n 

Includes formfeeds in output file 

Defines number of lines that must agree to con¬ 
stitute a match; n can be 1 to 310; default is 3 

IS 

n 

/V: i:d 

Ignores spaces and tabs when comparing 
Includes trailing spaces and tabs in comparison 
Defines characters to use as markers for in¬ 
serts and deletions in place of change bars and 
bullets; use with /D; / and of are the numeric 
values for the ASCII characters to use. 
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Programmed Requests 


RT-11 EMT 

Codes 

EMT 

Interpretation 

0-337 

Version 1 programmed requests with argu¬ 
ments both on the stack and in R0. 

340-357 

Programmed request with the arguments on 
the stack and/or in RO. 

360-373 

Used internally by the RT-11 monitor. 

374 

Programmed request with one argument; RO 
contains a function code in the left byte and a 
channel code in the right byte. 

375 

Programmed request with several arguments; 
RO points to a block of arguments. 

376 

Used internally by the RT-11 monitor. 

377 

Reserved; RT-11 ignores this EMT and returns 
control to the user program immediately. 
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.ABTIO 


EMT 374, CODE 13 


This request aborts all outstanding I/O requests on an I/O chan¬ 
nel. The .ABTIO request cannot be issued from a completion 
routine. 


Call: .ABTIO chan 

chan is the channel number for which to abort I/O 
requests. 


Format: RO = 

Errors: 


13 


chan 


None 


122 







.CDFN 


EMT 375, Code 15 


This request redefines the number of I/O channels. It allows the 
number of channels to be expanded from 16 to a maximum of 
255(decimal) channels, numbered from 0 to 254(decimal) or 0 to 
376(octal). 

Call: .CDFN area, addr, num 

area is the address of a 3-word EMT argument 
block. 

addr is the address where the I/O channels be¬ 
gin. 

num is the number of I/O channels to be created. 
Format: RO -> -- 


15 


0 


addr 


num 


Errors: 


Code 


Explanation 


0 


An attempt was made to define fewer channels 
than already exist. 
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.CHAIN 


EMT 374, Code 10 


This request allows a background program to pass control di¬ 
rectly to another background program without operator interven¬ 
tion. During a .CHAIN, the monitor reverts to the original ^(deci¬ 
mal) channels and all nonresident device handlers are released. 
The area in low memory from 500 to 507 must contain the de¬ 
vice name and file name (in Radix-50) to be chained to. The 
area from locations 510 to 777 is used to pass information be¬ 
tween the chained programs. 

.CHAIN cannot be used with virtual jobs. 

Call: .CHAIN 


Format: R0 = 


Errors: 



None 
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.CHCOPY EMT 375, Code 13 


(FB and XM Only) 


This request opens a channel, logically connecting it to a file that 
is currently open by another job for either input or output. A 
foreground, background, or system job can use this request. It 
must be issued before the first .READ or .WRITE request. 

Call: .CHCOPY area, chan, ochan [, jobblk] 

area is the address of a 3-word EMT argument 
block. 

chan is the channel the current job will use to 
read the data. 

ochan is the channel number of the other job’s 
channel to be copied. 

jobblk is a pointer to a 3-word ASCII logical job 
name that represents a system job. 

Format: RO -> -- 


13 chan 


ochan 


jobblk 


Errors: 


Code 


Explanation 


0 


Other job does not exist, does not have enough 
channels defined, or does not have the speci¬ 
fied channel (ochan) open. 

Channel (chan) already open. 
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.CLOSE 


EMT 374, Code 6 


This request terminates activity on a channel and frees it for use 
in another operation. The handler for the associated device must 
be in memory if the channel was opened with a .ENTER request. 

Call: .CLOSE chan 


chan is a channel number in the range 0 to 
376(octal). 


Format: RO = 


Errors: 


6 


chan 


Code Explanation 

3 A protected file with the same name already 

exists on the volume. The .CLOSE is per¬ 
formed anyway, resulting in two files with the 
same name on the volume. 
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.CMKT 


EMT 375, Code 23 


(FB and XM; SJ Option) 


This request cancels one or more outstanding mark time re¬ 
quests. The .CMKT request is a special feature in the SJ moni¬ 
tor. 


Call: .CMKT area, id [, time] 


area is the address of a 3-word EMT argument 
block. 

id is a number that identifies the mark time re¬ 

quest to be canceled. If more than one mark 
time request has the same id , .CMKT can¬ 
cels the request with earliest expiration 
time. If id is 0, .CKMT cancels all non-sys¬ 
tem mark time requests for the issuing job. 
time is the address of a 2-word area in which the 
monitor returns the amount of time, in clock 
ticks, remaining in the canceled request. 
The first word contains the high-order time, 
the second contains the low-order. If an ad¬ 
dress of 0 is specified, no value is returned. 
If id is 0, the time parameter is ignored and 
need not be included. 


Format: R0 -> 


Errors: 


23 


time 


Code Explanation 

0 The id was not 0 and a mark time request with 

a matching identification number could not be 
found. 
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.CNTXSW 


EMT 375, Code 33 


(FB and XM Only) 


A context switch is required when a transition is made from run¬ 
ning one job to running another. The .CNTXSW request is used 
to specify locations to be included in a list when the monitor 
switches between background, foreground, and system jobs. 
This request is ignored under SJ and in XM virtual jobs. 

Call: .CNTXSW area, addr 

area is the address of a 2-word EMT argument 
block. 

addr is a pointer to a list of addresses terminated 
by a 0 word. The addresses in the list must 
be even and be: 


a. in the range 2 to 476, or 

b. in the user job area, or 

c. in the I/O page (160000 to 177776). 


Format: R0 -> 


Errors: 


33 

0 

addr 


Code Explanation 

0 One or more of the requirements for addr was 

violated. 
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.CRAW 


EMT 375, Code 36 


(XM Only) 


This request defines a virtual address window and optionally 
maps it into a physical memory region. Mapping occurs if the 
WS.MAP bit in the last word of the window definition block is set 
before .CRAW is issued. 

Call: .CRAW area [, addr] 

area is the address of a 2-word EMT argument 
block. 

addr is the address of the window definition 
block. This argument is optional if the ad¬ 
dress pointer is already in the second word 
of the area argument block. 

Format: RO -> -- 


36 2 


addr 


Errors: 


Code 


Explanation 


0 


Window alignment error: the new window over¬ 
laps the static window for a virtual job. The win¬ 
dow is too large or W.NAPR is greater than 7. 
An attempt was made to define more than 
seven windows in the program. Eliminate a win¬ 
dow first by using the .ELAW request, or rede¬ 
fine the virtual address space into fewer win¬ 
dows. 


2 

4 


The combination of the offset into the region 
and the size of the window to be mapped into 
the region is invalid. 


An invalid region identifier was specified. 
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.CRRG EMT 375, Code 36 (XM Only) 

This request allocates a dynamic region in physical memory for 
use by the requesting job. 

Call: .CRRG area [, addr] 

area is the address of a 2-word EMT argument 
block. 

addr is the address of the region definition block 
for the region to be created. 


Format: RO -> 


Errors: 


36 

0 

addr 


Code Explanation 


6 


7 


10 


No region control blocks are available. Elimi¬ 
nate a region to obtain a region control block by 
using the .ELRG request, or redefine physical 
address space into fewer regions. 

A region of the requested size cannot be cre¬ 
ated because not enough memory is available. 
The size of the largest available region is re¬ 
turned in RO. 

An invalid region size was specified. Only val¬ 
ues greater than 0 and less than or equal to 
96K words are valid. 
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.CSIGEN 


EMT 344 


This request calls the Command String Interpreter (CSI) in gen¬ 
eral mode to process a standard RT-11 command string. In 
general mode, file .LOOKUP and .ENTER requests as well as 
handler .FETCH requests are performed. When called in general 
mode, the CSI closes channels 0 to 10(octal). 


In a foreground/background environment, calling the CSI per¬ 
forms a temporary and implicit .UNLOCK while the command 
line is being read. 


Call: 

.CSIGEN devspc, defext [, cstrng [, linbuf]] 


devspc is the address of the memory area where 
any device handlers are to be loaded. 


defext 

is the address of a 4-word block that con¬ 
tains the Radix-50 default file types. 


cstrng 

is the address of the ASCIZ command string 
or #0 if input is from the console terminal. 


linbuf 

is the storage address of the original com¬ 
mand string. This is a user-supplied area, 
81 bytes long. The command string in the 
buffer is terminated with a 0 byte. 

Errors: 

Code 


Explanation 

0 


Command line is invalid. 

1 


Device cannot be found in system tables. 

2 


Protected file of the same name already exists. 
A new file was not opened. 

3 


Volume does not have enough room to open 
output file(s). 

4 


Input file was not found. 


On return, RO points to the first available location above the 
handlers, the stack contains the option information, and the 
specified files have been opened. 
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.CSISPC 


EMT 345 


This request calls the Command String Interpreter (CSI) in spe¬ 
cial mode to parse a standard RT-11 command string and return 
file descriptors and options to the program. In this mode, the CSI 
does not perform any .CLOSE, .ENTER, .LOOKUP, or handler 
.FETCH requests. 

In a foreground/background environment, calling the CSI per¬ 
forms a temporary and implicit .UNLOCK while the command 
line is being read. 

Call: .CSISPC outspc, defext [, cstrng [, linbuf]] 

outspc is the address of the 39-word block to con¬ 
tain the file descriptors produced by 
.CSISPC. This area can overlay the space 
allocated to cstrng, if desired. The file de¬ 
scriptors are stored in Radix-50 format. The 
first 15 words are reserved for up to three 
output file descriptors. Each output file de¬ 
scriptor contains one word for the device 
name, two words for the file name, one 
word for the file type, and one word for any 
size specification, which is stored as a bi¬ 
nary integer. The next 24 words are re¬ 
served for up to six input file descriptors. 
Each input file descriptor contains one word 
for the device name, two words for the file 
name, and one word for the file type, 
defext is the address of a 4-word block that con¬ 
tains the Radix-50 default file types, 
cstrng is the address of the ASCIZ input string or a 
0 if input is to come from the console termi¬ 
nal. 

linbuf is the storage address of the original com¬ 
mand string. This is a user-specified area, 
81 bytes long. The command string is termi¬ 
nated with a 0 byte. 
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Errors: 


Errors are the same as in general mode except that invalid de¬ 
vice specifications are checked only for output file specifications 
with null file names. Since .LOOKUP and .ENTER requests are 
not done, the possible error codes are: 

Code Explanation 

0 Command line is invalid. 

1 Device specified is not available. 

CSI Option Information 

In both general and special modes of the CSI, options and their 
associated values are returned on the stack. A CSI option is a 
slash (/) followed by any character. The CSI does not restrict the 
option to printing characters, although they should be used for 
clarity. The option can be followed by a value, which is indicated 
by a colon (:) separator. The colon separator can be followed by 
an octal number, a decimal number, or by one to three alphanu¬ 
meric characters, the first of which must be alphabetic. Decimal 
values are indicated by a decimal point following the number 
(14.). If no decimal point is present, the number is assumed to 
be octal. Options can be associated with files. The format of the 
stack output of the CSI for options is as follows: 

Word 

Number Meaning 

1 Number of options found in command string. If 

0, no options were found 

2 Even byte = 7-bit ASCII option character. Bits 

8-14 = number (0-10) of the file with which 

the option is associated. Bit 15 = 1 if option 
had a value, 0 if option had no value. 

3 If bit 15 of word 2 is set, word 3 contains the 
option value. If bit 15 is not set, word 3 contains 
the next option character and file number, if 
any. 
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.CSTAT EMT 375, Code 27 

This request returns information about a channel. 

Call: .CSTAT area, chan, addr 

area is the address of a 2-word EMT argument 
block. 

chan is the number of the channel about which 
information is desired. 

addr is the address of a 6-word block to contain 
the status. 

Format: RO -> -- 


27 chan 


addr 


Errors: 


Code 


Explanation 


0 


Channel is not open. 


Information Returned: 


Offset 


Contents 


0 

2 

4 

6 

10 

12 


Channel status word (CSW) 

Starting block number of file 
Length of file 

Highest relative block number written 
Device unit number 
Device name in Radix-50 
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Channel Status Word (CSW) Bit Definitions: 


HDERR$ 

1 

Hard error 

INDX$M 

76 

Index mask into $PNAME and other de¬ 
vice tables 

RENAM$ 

100 

Rename operation in progress 

DWRIT$ 

200 

File opened with .ENTER; monitor will 
modify directory when file is closed 

DBLK$M 

17400 

Mask for directory segment containing 
this entry 

EOF$ 

20000 

(14) 

End-of-file found on this channel 
Reserved 

ACTIV$ 

100000 

Channel is active 


.CTIMIO Macro Expansion 

Use this request when writing a device handler. The .CTIMIO 
request cancels a pending device time-out (.TIMIO) request in 
the handler interrupt service section. It is used when an interrupt 
occurs to disable a pending .TIMIO completion routine. 

Call: .CTIMIO tblk 

tblk is the address of the 7-word timer block 
used by the .TIMIO request. 

Errors: 

None 
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.DATE 


EMT 374 


This request returns in RO the current date information from the 
system date word. The year is in bits 0 to 4, the day in bits 5 to 9, 
and the month in bits 10 to 13. The year is the actual year minus 
1972. 

Call: .DATE 


Format: RO = 


Errors: 



None 

On return, a value of 0 in RO indicates that the system date has 
not been set. 
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.DELETE 


EMT 375, Code 0 


This request deletes a named file from an RT-11 volume. The 
channel specified must not be open. The .DELETE request is 
invalid for magtapes. 

Call: .DELETE area, chan, dblk, [, seqnum] 


area is the address of a 3-word EMT argument 
block. 

chan is a free channel number in the range 0 to 
376(octal). 

dblk is the address of a 4-word Radix-50 de¬ 
scriptor of the file to be deleted, 
seqnum file number for cassette operations; if this 
argument is blank, a value of 0 is assumed. 


Format: RO -> 


Errors: 


chan 


dblk 


seqnum 


Code Explanation 


0 Channel is active. 

1 File was not found in the volume’s directory. 

2 Operation is invalid; device is not file struc¬ 
tured. 

3 The file is protected and cannot be deleted. 
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.DEVICE 


EMT 375, Code 14 


(FB and XM Only) 


This request allows a user program to load device registers 
when the program terminates. The .DEVICE request sets up a 
list of addresses with specified values. When the job terminates, 
the monitor goes through the list and the designated addresses 
are loaded with the corresponding values. 

Call: .DEVICE area, addr [, link] 


area is the address of a 2-word EMT argument 
block. 

addr is the address of a list of 2-word elements, 
each composed of a 1 -word address and a 
1-word value to be put at that address. If 
addr is #0, any previous list is discarded; in 
this form, the argument link must be omit¬ 
ted. 

link is an optional argument that, if present, 
specifies linking of tables on successive 
calls to .DEVICE. 


Format: R0 -> 


Errors: 


14 

0/1 

addr 


nonlinking/linking 


None 
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.DRAST 


Macro Expansion 


Use this request when writing a device handler. The .DRAST 
request sets up the interrupt and abort entry points, lowers the 
processor priority, and references a global symbol $INPTR, 
which contains a pointer to the INTEN routine in the resident 
monitor. This pointer is filled in for a system handler when the 
system is bootstrapped. The pointer is filled in for other handlers 
when they are loaded by the .FETCH request. 

Call: .DRAST name, pri [, abort] 

name is the 2-character device name. 

pri is the priority of the device, and also the 
priority at which the interrupt service code is 
to execute. 

abort is an optional argument that represents the 
label of an abort entry point. If you omit this 
argument, the macro generates an RTS PC 
instruction at the abort entry point, which is 
the word immediately preceding the inter¬ 
rupt entry point. 
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.DRBEG 


Macro Expansion 


This request sets up the information in block 0 and the first five 
words of a device handler. This macro also generates the appro¬ 
priate global symbols for the handler. Before using .DRBEG, use 
.DRDEF to define dd$CSR, dd$VEC, ddDSIZ, and ddSTS. 

Call: .DRBEG name 

name is the 2-character device name. 


The first five words of a handler are: 

ddSTRT 

Device vector 

- 

Offset to interrupt routine 

- 

Priority (340) 

ddLQE 

Pointer to last queue element 

ddCQE 

Pointer to current queue element 
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.DRBOT 


Macro Expansion 


This macro sets up a primary driver. A primary driver must be 
added to a standard handler to create a system device handler. 
The .DRBOT macro uses the .DREND macro to mark the end of 
the handler so that the primary driver is not loaded into memory 
during normal operations. 

Call: .DRBOT name, entry, read [.CONTROL = 

type[,...type]][,SIDES = n] 

name is the 2-character device name, 
entry is the entry point of the software bootstrap 
routine. 

read is the entry point of the bootstrap read rou¬ 
tine. 

type is the type of controller supported by the 
handler. If CONTROL is omitted, .DRBOT 
defaults to UBUS and QBUS. This default is 
correct for all supported Version 5 handlers, 
n specifies single- or double-sided diskettes. 

If SIDES is omitted, .DRBOT defaults to sin¬ 
gle-sided diskettes. This default is correct 
for all supported Version 5 handlers. 
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.DRDEF 


Macro Expansion 


This macro sets up device handler parameters, calls other de¬ 
vice handler macros from the library, and defines symbols. 

Call: .DRDEF name, code, stat, size, csr, vec 

name is the 2-character device name, 
code is the numeric code that is the device identi¬ 
fier value for the device. 

stat is the device status bit pattern. The value for 
stat can use the following symbols: 


VARSZ$ = 

400 

Handler returns vol¬ 
ume sizes 

ABTIO$ = 

1000 

Enter at abort entry 
point when job exits 

SPFUN$ = 

2000 

Accepts .SPFUN 
requests 

HNDLR$ = 

4000 

Enter at abort entry 
point on job abort 

SPECL$ = 

10000 

No directory 

WONLY$ = 

20000 

Write-only 

RONLY$ » 

40000 

Read-only 

FILST$ = 

100000 

File structured 

is the size of the volume in 256-word blocks, 
is the default value for the device’s control 


and status register. 

vec is the default value for the device’s interrupt 
vector. 
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.DREND 


Macro Expansion 


This macro generates the termination table for the termination 
section of a device handler. 

Call: .DREND name 

name is the 2-character device name. 

The .DREND macro generates the following table: 

SRLPTR: .WORD 0 ($RELOC,XM only) 

$MPPTR: .WORD 0 ($MPPHY,XM only) 

SGTBYT: .WORD 0 ($GETBY,XM only) 

$PTBYT: .WORD 0 ($PUTBY,XM only) 

SPTWRD: .WORD 0 ($PUTWR,XM only) 

$ELPTR: .WORD 0 ($ERLOG,Error Logging) 

$TIMIT: .WORD 0 ($TIM 10,Device Timeout) 

$INPTR: .WORD 0 ($INTEN) 

$FKPTR: .WORD 0 ($FORK) 
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.DRFIN 


Macro Expansion 


This macro generates the position-independent instructions for 
the jump back to the monitor at the end of a handler’s I/O com¬ 
pletion section. It also makes the pointer to the current queue 
element, ddCQE, a global symbol. When control passes to the 
monitor after the jump, the monitor releases the current queue 
element. 

Call: .DRFIN name 

name is the 2-character device name. 
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.DRSET 


Macro Expansion 


This macro sets up, in block 0 of a device handler, the option 
table for a SET command. Use once for each SET option. 

Call: .DRSET option, val, rtn [, mode] 

option is the name of the SET option. It can be up 
to six alphanumeric characters long with no 
embedded spaces or tabs. 

val is a parameter that is passed to the routine 
in R3. It must not be 0. 

rtn is the name of the routine that modifies the 
code in block 1 of the handler. The routine 
must follow the option table in block 0 and 
must not go above address 776. When the 
routine is entered, R0, R1, and R3 contain: 
R0 = numeric value, if any, from SET com¬ 
mand line 

R1 = unit number; if none specified, bit 15 
is set 

R3 = the parameter val 

mode is an optional argument to indicate the type 
of SET parameter. 

NO — a NO prefix is valid. 

NUM — a decimal number is required. 
OCT — an octal number is required. 

The .DRSET macro generates the following table: 

Offset Contents 

0 Value to pass in R3 to SET routine 

2 Radix-50 of option name (first word) 

4 Radix-50 option name (second word) 

6 100 = decimal argument required 
140 = octal argument required 
200 = NO prefix is valid 

7 Pointer to SET routine in handler 
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.DRVTB 


Macro Expansion 


This macro sets up a table of 3-word entries for each vector of a 
multivector device. Use .DRVTB once for each vector. The table 
entries contain the vector location, interrupt entry point, and 
processor status word. 

Call: .DRVTB name, vec, int [, ps] 

name is the 2-character device name. If the device 
has multiple vectors, leave this argument 
blank after the first use of .DRVTB in the 
handler. 

vec is the address of the vector, and must be 
from 0 to 474. 

int is the symbolic name of the interrupt han¬ 
dling routine. This is generally of the form 
ddINT, where dd is the 2-character device 
name. 

ps is an optional value that specifies the low- 
order four bits of the new processor status 
word in the interrupt vector. It defaults to 0 if 
omitted. 
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.DSTATUS 


EMT 342 


This request obtains information about a particular device. If 
.DSTATUS is successful, it returns four words of status informa¬ 
tion starting at the address specified by addr. 

Call: .DSTATUS addr, dnam 

addr is the address of a 4-word block that stores 
the status information. 

dnam is the address of a word containing the Ra- 
dix-50 device name. 

Errors: 

Code Explanation 

0 Device was not found in tables. 
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.DSTATUS 

Information Block 

Word 0: 

Device 

(0-7) 

Characteristics 

Contains the RT-11 device code 

VARSZ$ 

400 

0 = .SPFUN 373 requests are invalid 
for this handler 

1 = .SPFUN 373 requests (return 
volume size) are valid for this 
handler (VARSZ$ = 1 forces 
SPFUN$ = 1) 

ABTIO$ 

1000 

0 = Handler not entered at abort en¬ 
try on normal program exits 

1 = Handler entered at abort entry 
whenever a program terminates 

SPFUN$ 

2000 

0 = No .SPFUN requests accepted 

1 = Handler accepts .SPFUN re¬ 
quests 

HNDLR$ 

4000 

0 = Handler abort entry taken only if 
an active queue element exists 
for aborted program 

1 = Handler abort entry taken every 
time program is aborted 

SPECL$ 

10000 

1 = Non-RT-11 directory-structured 
device 

WONLY$ 

20000 

1 = Write-only device 

RONLY$ 

40000 

1 = Read-only device 

FILST$ 

100000 

0 = Sequential access device 

1 = Random access device 

Word 1: 

Handler Size 

The size of the handler in bytes. 

Word 2: 

Load address + 6 


If word 2 is 0, the handler is not in memory and 
must be fetched before it can be used. The ad¬ 
dress returned is the load address of the handler 

+ 6. 
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Word 3: 


Volume Size 


The size in 256-word blocks of the volume for 
block-replaceable devices. This will be the smallest 
size volume for variable-size devices, or 0 for se¬ 
quential devices. The last block on the volume is 
the volume size -1. 


.ELAW EMT 375, Code 36 


(XM Only) 


This request eliminates a virtual address window. An implied 
unmapping of the window occurs when its definition block is 
eliminated. 

Call: .ELAW area [, addr] 

area is the address of a 2-word EMT argument 
block. 

addr is the address of the window definition block 
for the window to be eliminated. If the sec¬ 
ond word of the EMT argument block is al¬ 
ready filled in, addr need not be specified. 

Format: RO -> -- 


36 


3 


addr 


Errors: 


Code 


Explanation 


3 


An invalid window identifier was specified. 
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.ELRG 


EMT 375, Code 36 


(XM Only) 


This request eliminates a dynamic region in physical memory 
and returns the memory to the free list where it can be used by 
other jobs. 


Call: 


.ELRG area [, addr] 


area 

addr 


is the address of a 2-word EMT argument 
block. 

is the address of the region definition block 
for the region to be eliminated. Windows 
mapped to this region are unmapped. The 
static region, region 0, cannot be eliminated. 
If the second word of the EMT argument 
block is aready filled in, addr need not be 
specified. 


Format: R0 -> 


36 

1 

addr 


Errors: 

Code 

2 


Explanation 

An invalid region identifier was specified. 


.ENTER 


EMT 375, Code 2 


For file-structured devices, this request allocates space on the 
volume, creates a tentative entry in the volume’s directory for the 
new file, and assigns the specified I/O channel number to the 
new file. For sequential devices such as a line printer, .ENTER 
assigns the I/O channel number to the device. 


Call: 


.ENTER area, chan, dblk, len [, seqnum] 
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area is the address of a 4-word EMT argument 
block. 

chan is an unused channel number in the range 0 
to 376(octal). 

dblk is the address of a 4-word Radix-50 de¬ 
scriptor of the file to be created. If this word 
is 0, a non-file-structured .LOOKUP is done 
on the device. 

len is the file size specification. 

seqnum is a file sequence number for magtape or 
cassettes. 



Errors: 


Code Explanation 

0 Channel is in use. 

1 In a fixed-length request, no space greater than 
or equal to amount requested was found, or the 
volume’s directory was full. 

2 Non-sharable device is already in use by an¬ 
other job. 

3 A file with that name already exists and is pro¬ 
tected. A new file was not opened. 

4 File sequence number was not found. 

5 File sequence number is invalid or file name is 

null. 

On return, R0 contains the size of the area allocated for use on a 
file-structured device. R0 returns 0 for sequential or non-file- 
structured devices. 
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.EXIT 


EMT 350 


The .EXIT request terminates a user program. When used from 
a background job under the FB or XM monitors, or in SJ, .EXIT 
causes KMON to run in the background area. All outstanding 
mark time requests are canceled. Any I/O requests and/or com¬ 
pletion routines pending for that job are allowed to complete. If 
R0 = 0, an implicit .HRESET is executed when KMON is entered. 

Call: .EXIT 

Errors: 


None 

The .EXIT request allows a user program to pass command 
lines to KMON in the chain information area (locations 500 to 
777) for execution after the job exits. This is performed under the 
following conditions: 

1) Location 510 contains the total number of bytes in the com¬ 
mand lines to be passed to KMON. 

2) Command lines are stored beginning at location 510 and 
must be .ASCIZ strings with no embedded carriage return 
or linefeed characters. 

3) The user program sets bit 11 in the job status word immedi¬ 
ately before an .EXIT issued with R0 = 0. In addition, if bit 5 
of the JSW is set before the .EXIT, the status of any cur¬ 
rently active indirect command file will be preserved. 
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.FETCH 


EMT 343 


This request loads device handlers into memory from the system 
volume. This request is valid only for background jobs. 

Call: .FETCH addr, dnam 

addr is the address where the device handler is 
to be loaded. 

dnam is the pointer to the Radix-50 device name. 

Errors: 

Code Explanation 

0 Either the device name specified is not installed 

in the system, or there is no handler for that 
device on the system volume. 

On return, RO points to the first available location above the 
handler. 


153 



.FORK 


Macro Expansion 


Use this macro in a device handler or interrupt service routine 
when access to a shared resource must be serialized or when a 
lengthy but non-time-critical section of code must be executed. 

Call: .FORK fkblk 

fkblk is a 4-word block of memory allocated within 
the handler. 


Errors: 


None 

The .FORK macro expands as follows: 

.FORK fkblk 

JSR R5,@$FKPTR 

.WORD fkblk-. 

The .FORK macro issues a subroutine call to the monitor and 
does not use an EMT request. The .FORK call must be pre¬ 
ceded by an .INTEN call, and the address of a 4-word block 
must be supplied with the request. This block is used as the fork 
queue element by the monitor. The program must not have left 
any information on the stack between the .INTEN and the 
.FORK call. The contents of registers R4 and R5 are preserved 
through the call, and on return registers RO through R3 are avail¬ 
able for use. The .FORK returns to the calling point with the 
interrupt dismissed and the priority at 0. 
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.FPROT 


EMT 375, Code 43 


This request sets or removes file protection status for an individ¬ 
ual file. Protected files cannot be deleted by .DELETE, .ENTER, 
or .RENAME programmed requests. 

Call: .FPROT area, chan, dblk [, prot] 

area is the address of a 3-word EMT argument 
block. 

chan is a free channel number in the range 0 to 
376(octal). 

dblk is the address of a 4-word block with the 
filespec in Radix-50 of the file whose pro¬ 
tection is to be set or removed. 

prot value of 1 protects the file from deletion; 
value of 0 or omitted value removes the 
file’s protection. 

Format: RO -> -- 


43 chan 


dblk 


prot 


Errors: 


Code 


Explanation 


0 


Channel is in use. 
File was not found. 
Operation is invalid. 


3 
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.GMCX 


EMT 375, Code 36 


(XM Only) 


This request returns the mapping status of an extended memory 
window. Status is returned in the window definition block, and 
can be used in a subsequent mapping operation. 

Call: .GMCX area [, addr] 

area is the address of a 2-word EMT argument 
block. 

addr is the address of the window definition block 
where the specified window’s status is re¬ 
turned. If the second word of the EMT argu¬ 
ment block is already filled in, addr need not 
be specified. 


Format: RO -> 


Errors: 


36 

6 

addr 


Code Explanation 

3 An invalid window identifier was specified. 
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.GTIM 


EMT 375, Code 21 


This request allows user programs to access the current time of 
day. The time is returned in two words as the number of clock 
ticks past midnight. The high-order time is returned in the first 
word, the low-order time in the second word. 

Call: .GTIM area, addr 


area is the address of a 2-word EMT argument 
block. 

addr is the address of the 2-word area where the 
time is to be returned. 


Format: RO -> 


Errors: 


21 

0 

addr 


None 
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.GTJB 


EMT 375, Code 20 


This request returns information about a job in the system. 

Call: .GTJB area, addr [, jobblk] 

area is the address of a 3-word EMT argument 
block. 

addr is the address of an 8- or 12-word block into 
which the job parameters are passed. 

jobblk is a pointer to a 3-word ASCII job name for 
which data is being requested. If jobblk is 
omitted or is #-3, only the first eight words 
of information are returned. 



Errors: 


Code Explanation 

0 No such job is currently running. 


Information Returned: 


Word 

Offset 

Contents 

1 

0 

Job number (priority*2) 

2 

2 

High-memory limit 

3 

4 

Low-memory limit 

4 

6 

Pointer to I/O channel space 

5 

10 

Address of job’s impure area 

6 

12 

Low byte: unit number of job’s con¬ 



sole terminal 



High byte: reserved 

7 

14 

Virtual high limit 

8-9 

16-20 

Reserved 

10-12 

22-27 

ASCII logical job name 
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.GTLIN 


EMT 345 


This request collects a line of-input from either the console termi¬ 
nal or an indirect command file, if one is active. It requires the 
USR, but the format of the input line is not checked. 

In a foreground/background environment, calling .GTLIN per¬ 
forms a temporary and implicit .UNLOCK while the command 
line is being read. 

Call: .GTLIN linbuf [, prompt] [,type] 

linbuf is the address of the buffer to receive the 
input line. The size of linbuf should be 
81 (decimal) bytes. The input line is stored in 
this area, terminated with a 0 byte. 

prompt is an optional argument and is the address 
of a prompt string to be printed on the con¬ 
sole terminal. The prompt string must have 
the same format as the argument of a 
.PRINT request. 

type is an optional argument that forces .GTLIN 
to accept input only from the console termi¬ 
nal. 

Errors: 

Code Explanation 

0 Input line is longer than 80 characters. 


159 




.GVAL 


EMT 375, Code 34 


This request returns a monitor offset value in RO. This request 
must be used in an XM monitor environment to access the moni¬ 
tor’s fixed offset locations, and should be used with all monitors 
to ensure compatibility. Refer to .PVAL. 


Call: .GVAL area, offset 

area is the address of a 2-word EMT argument 
block. 

offset is the displacement from the beginning of 
the monitor to the word to be returned to RO. 


Format: RO -> 


Errors: 

Code 

0 


34 

0 

offset 


Explanation 

The offset requested is beyond the limits of the 
resident monitor. 
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.HERR 


EMT 374, Code 5 


This request turns off user interception of monitor errors. It al¬ 
lows the system to abort the job on fatal errors and generate an 
error message. This is the default case unless a .SERR has 
been done. 

Call: .HERR 


Format: RO = 



Errors: 

None 


.HRESET EMT 357 

This request stops all I/O transfers in progress for the issuing 
job, and then performs an .SRESET request. The SJ monitor 
uses a hardware RESET instruction to terminate I/O. 

Call: .HRESET 

Errors: 


None 
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.INTEN 


Macro Expansion 


This request is used by device handler interrupt service routines 
to notify the monitor that an interrupt has occurred, to switch to 
system state, to set the processor priority to the correct value, 
and to save the contents of R4 and R5 before returning to the 
interrupt service routine. 

Call: .INTEN prio [, pic] 

prio is the processor priority at which to run the 
interrupt routine. 

pic is an optional argument that should be 
specified if the interrupt routine is written as 
a PIC routine. 

Errors: 

None 

The .INTEN request issues a subroutine call to the monitor and 
does not use an EMT request. All external interrupts must raise 
the processor to priority level 7. Use .INTEN to lower the priority 
to the value at which the device should be run. On return from 
.INTEN, the device interrupt can be serviced, at which point the 
interrupt routine can exit with an RTS PC. 


.LOCK EMT 346 

This request keeps the USR in memory to provide services re¬ 
quired by the user program. In the FB monitor, a .CSIGEN, 
.CSISPC, or .GTLIN request performs an implicit and temporary 
.UNLOCK. 

Call: .LOCK 

Errors: 

None 
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.LOOKUP 


EMT 375, Code 1 


This request associates a specified channel with a device and 
file for I/O operations. The handler for the selected device must 
be in memory for this request. 

Call: .LOOKUP area, chan, dblk [, seqnum] 

area is the address of a 3-word EMT argument 
block. 

chan is a channel number in the range 0 to 
376(octal). 

dblk is the address of a 4-word Radix-50 de¬ 
scriptor of the device and file to be ac¬ 
cessed. 

seqnum is a file number for magtapes and cassettes. 



Errors: 


Code Explanation 

0 Channel is in use. 

1 File indicated was not found on the volume. 

2 File already open on a non-sharable device; for 
example, magtape. 

5 Argument is invalid. 

On return, RO contains the length in blocks of the file just 
opened. On return from a .LOOKUP for a non-directory, file- 
structured device, RO contains 0 for the length. 
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.MAP EMT 375, Code 36 


(XM Only) 


This request maps a previously defined address window into a 
dynamic region of extended memory or into the static region in 
the lower 28K. If the second word of the EMT argument block is 
aready filled in, addr need not be specified. 

Call: .MAP area [, addr] 

area is the address of a 2-word EMT argument 
block. 

addr is the address of the window definition block 
containing a description of the window to be 
mapped and the region to which it will map. 

Format: RO -> -- 


36 


4 


addr 


Errors: 


Code 


Explanation 


2 

3 

4 


An invalid region identifier was specified. 
An invalid window identifier was specified. 


The specified window was not mapped be¬ 
cause the offset is beyond the end of the re¬ 
gion, the region is larger than the window, or 
the window would extend beyond the bounds of 
the region. 
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.MFPS 


Macro Expansion 


This macro call allows processor-independent user access to 
the processor status word. The .MFPS call is used to read the 
priority bits only. Condition codes are destroyed during the call 
and must be directly accessed prior to using the .MFPS macro. 

Call: .MFPS [addr] 

addr is the address into which the processor 
status is to be stored; if addr is not present, 
the value is returned on the stack. Only the 
priority bits are significant. 
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.MRKT 


EMT 375, Code 22 


This request schedules a completion routine to be entered after 
a specified time interval (measured in clock ticks) has elapsed. 

Call: .MRKT area, time, crtn, id 


area is the address of a 4-word EMT argument 
block. 

time is the address of a 2-word block containing 
the time interval (high order first, low order 
second) specified as a number of clock 
ticks. 

crtn is the entry point of a completion routine, 
id is a non-0 number assigned by the user to 

identify the particular request to the comple¬ 
tion routine and to any .CMKT requests. 
The number must not be in the range 
177000 to 177777, which is reserved for 
system use. 



Errors: 


Code Explanation 

0 No queue element was available. 


On entry to the completion routine, R0 contains the id number. 
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.MTATCH 


EMT 375, Code 37 


This request attaches a terminal for exclusive use by the re¬ 
questing job. 


Call: 


.MTATCH area, addr, unit 


area 


addr 


unit 


is the address of a 3-word EMT argument 
block. 

is the optional address of an asynchronous 
terminal status (AST) word or it must be #0. 
(The AST word is a SYSGEN option.) 
is the logical unit number of the terminal. 


Format: R0 -> 


37 

5 

addr 

0 

unit 


Errors: 


Code Explanation 


2 

3 

4 

5 


Logical unit number does not exist. 

Function code is out of range. 

Unit is attached by another job; other job’s 
number is returned in R0. 

In the XM monitor, the status word address is 
not in valid user virtual address space. 


Asynchronous Terminal Status Word (T.AST) 



(0-5) 

Reserved 

AS.HNG 

100 

Remote line hung up 

AS.CAR 

200 

Carrier is present 


(8-12) 

Reserved 

AS.OUT 

20000 

Output ring buffer is empty 

AS.INP 

40000 

Input is available from terminal 

AS.CTC 

100000 

Multiple (ctrl/ c )s typed at terminal 
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.MTDTCH EMT 375, Code 37 

This request detaches a terminal from one job and makes the 
terminal available for other jobs. 

Call: .MTDTCH area, unit 


area is the address of a 3-word EMT argument 
block. 

unit is the logical unit number (lun) of the termi¬ 
nal to be detached. 


Format: RO -> 


Errors: 


37 

6 

unused 

— 

unit 


Code 


Explanation 


Unit number is invalid; unit is not attached. 
Unit does not exist. 

Request is invalid; function code is out 
range. 


of 
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.MTGET 


EMT 375, Code 37 


This request returns the status of the specified terminal unit to 
the caller. 


Call: .MTGET area, addr, unit 


area is the address of a 3-word EMT argument 
block. 

addr is the address of a 4-word block where the 
status information is returned, 
unit is the logical unit number (lun) of the termi¬ 
nal for which status is requested. A unit 
need not be attached to the job issuing a 
.MTGET request. 


Format: RO -> 


Errors: 


37 

1 

addr 

— 

unit 


Code Explanation 


1 

2 

3 

4 

5 


Unit number is invalid; unit is not attached. 

Unit does not exist. 

Request is invalid; function code is out of 
range. 

Unit is attached by another job. 

With the XM monitor, the status block address 
is not in valid user virtual address space. 


If an .MTGET request fails because the terminal is attached by 
another job, the job number of the owner is returned in RO and 
the terminal status is returned. For all other error conditions, RO 
is undefined. The .MTGET request returns the multiterminal 
status block. 
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Multiterminal Status Block 


M.TSTS 

M.TST2 

M.FCNT 

M.TFIL 

M.TSTW 

M.TWID 


0 

2 

4 

6 


Terminal Configuration Word 1 (M.TSTS, offset = 0) 


1 

Hardware tab 

2 

Output carriage return/linefeed when carriage 
width exceeded 

4 

Hardware formfeed 

10 

fcTRL/F J T (Ctrl/b ] r and (Ctrl 730 processed as normal 
characters 

(4-5) 

Reserved 

100 

Inhibit TT wait 

200 

XON/XOF processing enabled 

7400 

Line speed (baud rate) mask 

10000 

Character mode input 

20000 

Terminal is remote 

40000 

Lowercase to uppercase conversion disabled 

100000 

Backspace used for character deletion 


Line Speed Mask (bits 8 to 11 in M.TSTS) 


Mask 

Speed 

0000 

50 

0400 

75 

1000 

110 

1400 

134.5 

2000 

150 

2400 

300 

3000 

600 

3400 

1200 


Mask 

Speed 

4000 

1800 

4400 

2000 

5000 

2400 

5400 

3600 

6000 

4800 

6400 

7200 

7000 

9600 

7400 

unused 
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Multiterminal Status Block (cont.) 

Terminal Configuration Word 2 (M.TST2, offset = 2) 


3 

Character length (0-1) 

4 

Unit stop 

10 

Parity enable 

20 

Odd parity 

(5-6) 

Reserved 

200 

Read pass all 

(8-14) 

Reserved 

100000 

Write pass all 

Terminal State Byte (M.TSTW, offset = 7) 

1 

Fill sequence in progress 

2 

(Ctrl/ u J in progress 

(2-3) 

Reserved 

20 

Detach in progress 

40 

.PRINT/.WRITE synch flag 

100 

Output interrupt expected 

200 

XON/XOFF processing enabled 

(8-9) 

Reserved 

2000 

Terminal is shared console 

4000 

Terminal has hung up 

10000 

Terminal interface is DZ11 

(13) 

Reserved 

40000 

Double (Ctrl/ c) was struck 

100000 

Terminal is acting console 









.MTIN 


EMT 375, Code 37 


This request reads characters from the keyboard buffer. The 
.MTIN request is the multiterminal form of the .TTYIN request. 
The .MTIN request moves one or more characters to the buffer 
specified. 

Call: .MTIN area, addr, unit [, chrcnt] 


area is the address of a 3-word EMT argument 
block. 

addr is the byte address of the user buffer, 

unit is the logical unit number of the terminal in¬ 

put. 

chrcnt is a character count indicating the number 
of characters to transfer. The valid range is 
from 0 to 255. A count of 0 transfers one 
character. 


Format: RO -> 


37 

2 

addr 

chrcnt 

unit 


Errors: 


Code Explanation 

0 No input is available. 

1 Unit number is invalid; unit is not attached. 

2 Logical unit number does not exist. 

3 Request is invalid; function code is out of 

range. 

5 With the XM monitor, the user buffer address is 

not in valid user virtual address space. 


On return, RO contains the updated buffer address, pointing past 
the last character transferred. 
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.MTOUT 


EMT 375, Code 37 


This request transfers characters to the terminal output buffer. 
This request is the multiterminal form of the .TTYOUT request. 
The .MTOUT request moves one or more characters from the 
user’s buffer to the output ring buffer of the terminal. 

Call: .MTOUT area, addr, unit [, chrcnt] 


area is the address of a 3-word EMT argument 
block. 

addr is the address of the caller’s input buffer, 

unit is the unit number of the terminal, 

chrcnt is a character count indicating the number 
of characters to transfer (1 to 255.). 


Format: RO -> 


37 

3 

addr 

chrcnt 

unit 


Errors: 

Code Explanation 


0 Output buffer is full. 

1 Unit number is invalid; unit is not attached. 

2 Unit number does not exist. 

3 Request is invalid; function code is out of 
range. 

5 With the XM monitor, the user buffer address is 

not in valid user virtual address space. 


On return, RO contains the updated buffer address, pointing past 
the last character transferred. 
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.MTPRNT 


EMT 375, Code 37 


This request prints one or more lines on the specified terminal. It 
is the multiterminal form of the .PRINT request. 

Call: .MTPRNT area, addr, unit 

area is the address of a 3-word EMT argument 
block. 

addr is the starting address of the character 
string to be printed. The string must be ter¬ 
minated with a null byte or a 200 byte. 

unit is the unit number associated with the termi¬ 
nal. 


Format: R0 -> 


37 

7 

addr 

— 

unit 


Errors: 


Code Explanation 

1 Unit number is invalid; unit is not attached. 

2 Unit number does not exist. 

5 With the XM monitor, the character string ad¬ 

dress is not in valid user virtual address space. 
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.MTPS 


Macro Expansion 


This macro call allows processor-independent user access to 
the processor status word. The .MTPS request sets the priority 
bits only. 

Call: .MTPS addr 

addr is the address of the word to be placed in 
the processor status word. If addr is not 
present, the processor status word is taken 
from the stack. The high byte on the stack is 
set to 0 when addr is present. 
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.MTRCTO 


EMT 375, Code 37 


This request resets the milo) switch of the specified terminal. It 
is the multiterminal form of the .RCTRLO request. 

Call: .MTRCTO area, unit 

area is the address of a 3-word EMT argument 
block. 

unit is the unit number associated with the termi¬ 
nal. 


Format: RO -> 


Errors: 


37 

4 

unused 

— 

unit 


Code Explanation 


1 

2 

3 


Unit number is invalid; unit is not attached. 

Unit does not exist. 

Request is invalid; function code is out of 
range. 
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.MTSET 


EMT 375, Code 37 


This request sets terminal and line characteristics for a terminal. 
It also determines the input/output mode of the terminal’s service 
requests. 

Call: .MTSET area, addr, unit 


area is the address of a 3-word EMT argument 
block. 

addr is the address of a 4-word status block con¬ 
taining the line and terminal status being 
set. Refer to the description following the 
.MTGET request. 

unit is the logical unit number associated with 
the line and terminal. 


Format: RO -> 


37 

1 

addr 

— 

unit 


Errors: 


Code Explanation 


1 

2 

3 

5 


Unit number is invalid; unit is not attached. 

Unit does not exist. 

Request is invalid; function code is out of 
range. 

With the XM monitor, the status block address 
is not in valid user virtual address space. 
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.MTSTAT 


EMT 375, Code 37 


This request returns multiterminal system status information. 

Call: .MTSTAT area, addr 

area is the address of a 3-word EMT argument 
block. 

addr is the address of an 8-word status block 
where multiterminal status information is re¬ 
turned. 

Format: RO -> -- 


37 


10 


addr 


0 


Errors: 


Code 


Explanation 


5 


With the XM monitor, the status block address 
is not in valid user virtual address space. 


Information returned in the status block: 


Offset 

0 

2 

4 

6 


(10-17) 


Contents 

Offset from RMON to first TCB 

Offset from RMON to console TCB 

Number of TCBs in the system (1 to 17 octal) 

Size of TCB in bytes 

Reserved 
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.MWAIT 


EMT 374, Code 11 


(FB and XM Only) 


This request suspends execution of the job issuing the request 
until all messages sent to or requested from another job have 
been received. 


Call: .MWAIT 


Format: RO = 


Errors: 



None 
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.PEEK 


EMT 375, Code 34 


This request returns the contents of a location in low memory (0 
to 28K). RT-11 utility programs use this request to examine lo¬ 
cations in the monitor. Refer to .POKE. 

Call: .PEEK area, addr 


area 

addr 


Format: R0 -> 


Errors: 


None 


is the address of a 2-word EMT argument 
block. 

is the address of the location to examine. 
The contents of the location are returned in 
R0. 


34 

1 

addr 


180 







.POKE 


EMT 375, Code 34 


This request deposits a value in a low memory location (0 to 
28K). Refer to .PEEK. 

Call: .POKE area, addr, value 

area is the address of a 3-word EMT argument 
block. 

addr is the address of the location to modify, 
value is the new value to deposit in the location. 
The old contents of the location are returned 
on R0. 



Errors: 


None 
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.PRINT 


EMT 351 


This request prints output on the console terminal. String printed 
can be terminated with either a 0 byte or an octal 200 byte. A 
carriage return/line feed combination is appended to a string 
ending in a 0 byte, while a string ending in an octal 200 byte 
leaves the cursor or carriage at the end of the printed line. 

Call: .PRINT addr 

addr is the address of the string to be printed. 


Errors: 

None 
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.PROTECT EMT 375, Code 31 


(FB and XM Only) 


The .PROTECT request gives a job exclusive control of a 2-word 
vector in the region 0 to 476. 

Call: .PROTECT area, addr 

area is the address of a 2-word EMT argument 
block. 

addr is the address of the word pair to be pro¬ 
tected. The argument addr must be a multi¬ 
ple of 4, and must be less than or equal to 
474(octal). The two words at addr and 
addr +2 are protected. 

Format: RO -> -- 


31 


0 


addr 


Errors: 


Code 


Explanation 


0 


Protect failure; locations are already in use. 
Address is greater than 474 or not a multiple of 
4. 
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.PURGE EMT 374, Code 3 

This request frees a channel without taking any other action. 
Call: .PURGE chan 


chan 

is the channel number to be purged. 

Format: RO - 

3 chan 

Errors: 


None 
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.PVAL 


EMT 375, Code 34 


This request changes the contents of a monitor offset. Refer to 
.GVAL. 

Call: .PVAL area, offset, value 

area is the address of a 3-word EMT argument 
block. 

offset is the displacement from the beginning of 
the monitor to the word to change. 

value is the new value to put in the location. The 
old contents of the location are returned in 
RO. 



Errors: 


Code Explanation 

0 The offset requested is beyond the limits of the 

resident monitor. 
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.QELDF 


Macro Expansion 


This macro symbolically defines I/O queue element offsets. The 
.QELDF macro defines the following values: 


Q.LINK 

= 0 

Link to next queue element 

Q.CSW 

= 2 

Pointer to channel status word 

Q.BLKN 

= 4 

Physical block number 

Q.FUNC 

= 6 

Special function code 

Q.JNUM 

= 7 

Job number 

Q.UNIT 

= 7 

Device unit number 

Q.BUFF 

= 8. 

User virtual memory buffer address 

Q.WCNT 

= 10. 

Word count 

Q.COMP 

= 12. 

Completion routine code 


Since handlers usually deal with queue element offsets relative 
to Q.BLKN, the .QELDF macro also defines the following sym¬ 
bolic offsets: 

Q$LINK = -4 
Q$CSW = -2 
Q$BLKN = 0 
Q$FUNC = 2 
Q$JNUM = 3 
Q$UNIT = 3 
Q$BUFF = 4 
Q$WCNT = 6 
Q$COMP = 8. 

For SJ and FB systems: 

Q.ELGH =14. Length of queue element 

For XM systems: 

Q.PAR = 14. PARI relocation bias 

Q$PAR = 10. 

Q.ELGH = 20. Length of queue element 

The .DRDEF macro automatically calls .QELDF. 
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.QSET 


EMT 353 


This request adds entries to the RT-11 I/O queue. The I/O 
queue initially has one queue element. Each program should 
allocate one more queue element than the total number of I/O 
requests that will be pending simultaneously on different chan¬ 
nels. 

Call: .QSET addr, len 

addr is the address at which the new elements 
are to start. 

len is the number of entries to be added. In the 
SJ and FB monitors, each queue entry is 7 
words long. In the XM monitor, each queue 
entry is lO(decimal) words long. 

Errors: 

None 

On return, RO contains the address of the first word beyond the 
allocated queue elements. 


.RCTRLO EMT 355 

This request ensures that the console terminal is able to print by 
resetting the CTRL/O switch for the terminal. The .RCTRLO re¬ 
quest should also be issued whenever any bits are changed in 
the JSW. This allows the monitor to update its internal status 
information to reflect the new contents of the JSW. 

Call: .RCTRLO 

Errors: 


None 
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.RCVD 


EMT 375, Code 26 


(FB & XM Only) 

This request queues a request to receive a message or data 
sent by another job in FB or XM environments. Execution of the 
job issuing the request continues. Use .MWAIT to wait until the 
message has been received. 

Note that .RCVDx and .SDATx use the same channel. A pro¬ 
gram should not issue synchronous (.RCVDW and .SDATW) 
requests and asynchronous (.RCVDC and .SDATC) requests at 
the same time because the synchronous requests will never re¬ 
turn. 

Call: .RCVD area, but, went 

area is the address of a 5-word EMT argument 
block. 

buf is the address of the buffer to which the 
message is to be sent. 

went is the number of words to be transferred. 



Errors: 


Code Explanation 

0 No other job exists in the system. 
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.RCVDC 


EMT 375, Code 26 


(FB and XM Only) 


This request queues a request to receive a message or data 
sent by another job in an FB or XM environment and specifies a 
completion routine to be entered when the message is received. 
Execution of the job issuing the request continues. 

Note that .RCVDx and .SDATx use the same channel. A pro¬ 
gram should not issue synchronous (.RCVDW and .SDATW) 
requests and asynchronous (.RCVDC and .SDATC) requests at 
the same time because the synchronous requests will never re¬ 
turn. 


Call: .RCVDC area, buf, went, ertn 


area is the address of a 5-word EMT argument 
block. 

buf is the address of the buffer to which the 
message is to be sent. 

went is the number of words to be transmitted, 

ertn is the address of a completion routine to be 

entered. 



Errors: 


Code Explanation 

0 No other job exists in the system. 
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.RCVDW 


EMT 375, Code 26 


(FB and XM Only) 

This request queues a request to receive a message or data 
sent by another job in FB or XM environments. Execution of the 
job issuing the request is suspended until all outstanding mes¬ 
sages have been sent or received. 

Note that .RCVDx and .SDATx use the same channel. A pro¬ 
gram should not issue synchronous (.RCVDW and .SDATW) 
requests and asynchronous (.RCVDC and .SDATC) requests at 
the same time because the synchronous requests will never re¬ 
turn. 

Call: .RCVDW area, but, went 

area is the address of a 5-word EMT argument 
block. 

buf is the address of the buffer to which the 
message is to be sent. 

went is the number of words to be transmitted. 



Errors: 


Code Explanation 

0 No other job exists in the system. 
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.RDBBK Macro Expansion (XM Only) 

This macro defines symbols and reserves space for the region 
definition block. .RDBBK automatically calls .RDBDF. 

Call: .RDBBK rgsiz 

rgsiz is the size of the dynamic region needed, 
expressed in 32-word units. 


.RDBDF Macro Expansion (XM Only) 

This macro defines the symbolic offset names for the region 
definition block and the names for the region status word bit 
patterns. .RDBDF also defines R.GLGH, the length of the region 
definition block. 

Call: 

.RDBDF 

Expansion: 

R.GID = 0 

R.GSIZ = 2 

R.GSTS = 4 

R.GLGH = 6 

RS.NAL = 20000 
RS.UNM = 40000 
RS.CRR = 100000 
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.READ 


EMT 375, Code 10 


This request transfers to memory a specified number of words 
from the device associated with the specified channel. Control 
returns to the user program immediately after the .READ is initi¬ 
ated. 

Call: .READ area, chan, buf, went, blk 

area is the address of a 5-word EMT argument 
block. 

chan is a channel number in the range 0 to 
376(octal). 

buf is the address of the buffer to receive the 
data read. 

went is the number of words to read, 
blk is the starting block number to read. 



Errors: 


Code 


Explanation 


0 

1 

2 


Attempt was made to read past end of file. 
Hard error occurred on channel. 

Channel is not open. 


On return, R0 contains the number of words transferred. This will 
be less than the number requested if end-of-file is reached on 
the input device. 
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.READC 


EMT 375, Code 10 


This request transfers a specified number of words from the 
channel to memory. Control returns to the user program immedi¬ 
ately after the .READC is initiated. Control passes to the comple¬ 
tion routine when the .READC is complete. 

Call: .READC area, chan, buf, went, ertn, blk 

area is the address of a 5-word EMT argument 
block. 

chan is a channel number in the range 0 to 
376(octal). 

buf is the address of the buffer to receive the 
data read. 

went is the number of words to read. 

ertn is the address of the completion routine and 

must be above 500(octal). 

blk is the block number to read. 



Errors: 


Code Explanation 

0 Attempt was made to read past end-of-file. 

1 Hard error occurred on channel. 

2 Channel is not open. 

On return, R0 contains the number of words transferred. This will 
be less than the number requested if end-of-file is reached on 
the input device. 
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.READW 


EMT 375, Code 10 


This request transfers a specified number of words from a chan¬ 
nel to memory. When the .READW is complete or an error is 
detected, control returns to the user program. 

Call: .READW area, chan, buf, went, blk 


area is the address of a 5-word EMT argument 
block. 

chan is the channel number in the range 0 to 
376(octal). 

buf is the address of the buffer to receive the 
data read. 

went is the number of words to read, 
blk is the block number to be read. 



Errors: 


Code 


Explanation 


0 Attempt was made to read past end-of-file. 

1 Hard error occurred on channel. 

2 Channel is not open. 

On return, R0 contains the number of words transferred. This will 
be less than the number requested if end-of-file is reached on 
the input device. 
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.RELEAS 


EMT 343 


This request notifies the monitor that a fetched device handler is 
no longer needed. The .RELEASE request is ignored if the han¬ 
dler is the system device handler, is not currently resident, or is 
resident because of a LOAD command to KMON. 

Call: .RELEAS dnam 

dnam is the address of the Radix-50 device 
name. 

Errors: 

Code Explanation 

0 Device name is invalid. 
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.RENAME 


EMT 375, Code 4 


This request changes the name of a file and puts the current 
system date in the file’s directory entry. 

Call: .RENAME area, chan, dblk 

area is the address of a 2-word EMT argument 
block. 

chan is a channel number in the range 0 to 
376(octal). 

dblk is the address of a block that specifies the 
file to be renamed followed by the new file 
name, in Radix-50. 


Format: RO -> 


Errors: 


4 

chan 

dblk 


Code Explanation 

0 Channel is open. 

1 File was not found. 

2 Operation is invalid (device is not file struc¬ 
tured). 

3 A protected file of the specified name already 
exists. The .RENAME is not performed. 
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.REOPEN EMT 375, Code 6 

This request reassigns a channel to a .SAVESTATUS block. 
This allows I/O to continue on the channel from the point at 
which the .SAVESTATUS was performed. 

Call: .REOPEN area, chan, cblk 

area is the address of a 2-word EMT argument 
block. 

chan is a channel number in the range 0 to 
376(octal). 

cblk is the address of the 5-word block where the 
.SAVESTATUS information was stored. 


Format: RO -> 


Errors: 

Code 

0 


6 

chan 

cblk 


Explanation 

The specified channel is in use. The .REOPEN 
is not performed. 


.RSUM EMT 374, Code 2 (FB & XM Only) 

This request resumes execution of a job’s mainline code after a 


.SPND. 

Call: .RSUM 

Format: RO = 

Errors: 



None 
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.SAVESTATUS 


EMT 375, Code 5 


This request stores five words of channel status information in 
memory. The channel is freed upon completion of the request. 
The channel can be reopened, possibly with a different channel 
number, by a .REOPEN request. 

Call: .SAVESTATUS area, chan, cblk 

area is the address of a 2-word EMT argument 
block. 

chan is a channel number in the range 0 to 
376(octal). 

cblk is the address of the 5-word user memory 
block where the channel status information 
is to be stored. 


Format: RO -> 


Errors: 


5 

chan 

cblk 


Code Explanation 


0 The channel specified is not associated with 

any file. 

1 The channel was opened with an .ENTER re¬ 

quest, or a .SAVESTATUS request was at¬ 
tempted for a magtape or cassette file. 
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.SCCA 


EMT 375, Code 35 


This request inhibits ffiE) abort, indicates when a double 
is initiated at the console, and distinguishes between sin¬ 
gle and double Ctrl/cj commands. Bit 15 of the terminal status 
word is set when consecutive EWcl characters are detected. 
The user program must clear the bit. 


Call: .SCCA area, addr 


area is the address of a 2-word parameter block, 
addr is the address of a terminal status word; an 
address of 0 re-enables the (ctrlTcI com¬ 
mand. 


Format: RO -> 


Errors: 


35 

0 

addr 


None 
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.SDAT 


EMT 375, Code 25 


(FB and XM Only) 

This request queues a request to send a message or data to 
another job in FB or XM environments. Execution of the job 
issuing the request continues. 

Note that .RCVDx and .SDATx use the same channel. A pro¬ 
gram should not issue synchronous (.RCVDW and .SDATW) 
requests and asynchronous (.RCVDC and .SDATC) requests at 
the same time because the synchronous requests will never re¬ 
turn. 

Call: .SDAT area, but, went 

area is the address of a 5-word EMT argument 
block. 

buf is the buffer address of the beginning of the 
message to transfer. 

went is the number of words to transfer. 



Errors: 


Code Explanation 

0 No other job exists. 
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.SDATC 


EMT 375, Code 25 


(FM and XM Only) 


This request queues a request to send a message or data to 
another job in FB or XM environments and specifies a comple¬ 
tion routine to be entered when the message has been transmit¬ 
ted. Execution of the job issuing the request continues. 

Note that .RCVDx and .SDATx use the same channel. A pro¬ 
gram should not issue synchronous (.RCVDW and .SDATW) 
requests and asynchronous (.RCVDC and .SDATC) requests at 
the same time because the synchronous requests will never re¬ 
turn. 


Call: .SDATC area, buf, went, ertn 


area is the address of a 5-word EMT argument 
block. 

buf is the buffer address of the beginning of the 
message to transfer. 

went is the number of words to transfer, 
ertn is the address of the completion routine to 
enter when the message has been transmit¬ 
ted. 


Format: RO -> 


Errors: 



Code 


0 


Explanation 
No other job exists. 
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.SDATW EMT 375, Code 25 (FB and XM Only) 

This request queues a request to send a message or data to 
another job in FB or XM environments. Execution of the job 
issuing the request is suspended until all outstanding messages 
are sent and received. 

Note that .RCVDx and .SDATx use the same channel. A pro¬ 
gram should not issue synchronous (.RCVDW and .SDATW) 
requests and asynchronous (.RCVDC and .SDATC) requests at 
the same time because the synchronous requests will never re¬ 
turn. 

Call: .SDATW area, but, went 

area is the address of a 5-word EMT argument 
block. 

buf is the buffer address of the beginning of the 
message to transfer. 

went is the number of words to transfer. 



Errors: 


Code Explanation 

0 No other job exists. 
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.SDTTM 


EMT 375, Code 40 


This request allows programs to set the system date and time. 
Call: .SDTTM area, addr 


area is the address of a 2-word EMT argument 
block. 

addr is the address of a 3-word block containing 
the new date and time. 


Format: R0 -> 


Errors: 


40 

0 

addr 


None 


Date/Time information block: 

Offset Contents 

0 Date in RT-11 format (-1 to leave date un¬ 

changed) 

2 High-order time (-1 to leave time un¬ 

changed) 

4 Low-order time 

The double-precision time is expressed in ticks past midnight. 
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.SERR 


EMT 374, Code 4 


This request inhibits job abort on monitor errors. If a monitor 
error occurs during a monitor request, the carry bit is set and 
byte 52 contains a negative value indicating the error condition 
that occurred. 


Call: .SERR 


Format: RO 


Errors: 

Code 

-1 

-2 

-3 


-5 

-6 

-7 

-10 

-11 

-12 

-13 

-14 

-15 


-16 

-17 

-20 

-21 

-22 



Explanation 

USR was called from a completion routine. 
Operation attempted to access an unloaded de¬ 
vice handler. 

I/O error occurred while accessing the direc¬ 
tory. 

Error occurred during a .FETCH request. 

Error occurred while reading an overlay. 
Attempt was made to do a .ENTER on a full 
directory. 

Attempt was made to access an invalid ad¬ 
dress. 

Invalid channel number was specified. 

Invalid EMT request was issued. 

Reserved for use by monitor. 

Reserved for use by monitor. 

Directory on a device is invalid. 

Attempt was made to fetch an unloaded han¬ 
dler while running an XM monitor that does not 
have .FETCH support. 

Reserved for use by monitor. 

Reserved for use by monitor. 

Reserved for use by monitor. 

Reserved for use by monitor. 

Reserved for use by monitor. 
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.SETTOP 


EMT 354 


This request specifies a new address as a program’s upper limit. 

Call: .SETTOP addr 

addr is the address of the highest word of the 
area desired; that is, the last word the pro¬ 
gram will modify, not the first word it leaves 
untouched. 

Errors: 

None 

On return, RO and location 50 contain the highest memory ad¬ 
dress allocated for use. 
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.SFDAT 


EMT 375, Code 42 


This request allows user and utility programs to set or modify the 
creation date in a file’s directory entry. 

Call: .SFDAT area, chan, dblk [, date] 


area is the address of a 4-word EMT argument 
block. 

chan is an unused channel number in the range 0 
to 376(octal). 

dblk is a 4-word block containing the filespec in 
Radix-50 of the file for which the date is to 
be modified. 

date is the address of the new date word in RT 
date format. If date is #0 or omitted, 
.SFDAT uses the current date. No check is 
made for an invalid date. 



Errors: 


Code Explanation 


0 

1 

2 

3 


Channel is in use. 

File was not found. 

Operation is invalid (device is not file struc¬ 
tured). 

File is protected. 
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.SFPA 


EMT 375, Code 30 


This request allows users with floating-point hardware to set trap 
addresses to be called when a floating-point exception occurs. 


Call: 

.SFPA 

area, addr 


area 

is the address of a 2-word EMT argument 
block. 


addr 

is the address of the routine to enter when 
an exception occurs. 

Format: R0 -> 



Errors: 


30 


addr 


None 
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.SPCPS EMT 375, Code 41 


(FB and XM Only) 


This request allows a program’s completion routine to change 
the flow of control of the mainline code. It saves the mainline 
code PC and PS and changes the mainline PC to a new value. If 
the mainline code is performing a monitor request, the monitor 
allows the request to finish before doing any rerouting. The ac¬ 
tual rerouting is deferred until the mainline code is about to run. 

Call: .SPCPS area, addr 

area is the address of a 2-word EMT argument 
block. 

addr is the address of a 3-word block in user 
memory that contains the new mainline PC, 
and that is to contain the old mainline PC 
and PS. 

Format: RO -> -- 


41 


0 


addr 


Errors: 


Code 


Explanation 


0 


The program issued the .SPCPS call from the 
mainline code rather than from a completion 
routine. 

A previous .SPCPS request is outstanding. 
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.SPFUN 


EMT 375, Code 32 


This request is used with certain device handlers for device¬ 
dependent functions, such as rewind, backspace, read/write ab¬ 
solute sectors, and size volume. 

Call: .SPFUN area, chan, func, buf, went, blk [, ertn] 

area is the address of a 6-word EMT argument 
block. 

chan is a channel number in the range 0 to 
376(octal). 

func is the numeric code of the function to be 
performed. 

buf is the buffer address; 0 if not used. 

went is defined in terms of the device handler. 

blk is also defined in terms of the device han¬ 
dler. 

ertn is the entry point of a completion routine. 



Errors: 


Code Explanation 

0 Attempt was made to read or write past end-of- 

file. 

1 Hard error occurred on channel. 

2 Channel is not open. 
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Function Codes for .SPFUN 


MM,MS,MT 

CT 



377 

Forward to last file 


376 

Forward to last block 


375 

Forward to next file 


374 

Forward to next block 

373 

373 

Rewind to load point 


372 

Write file gap 

377 


Write EOF 

376 


Forward one block 

375 


Backspace one block 

374 


Write with extended gap 

372 


Off-line rewind 

371 


Write 

370 


Read 

367 


Stream at 100 ips (MS only) 


DL,DM,DX,DY,LD 

377 Read (DL,DM,DX,DY) 

376 Write (DL,DM,DX,DY) 

375 Write with deleted data mark (DX,DY) 

374 Force read of bad block replacement table 

(DL.DM) 

373 Return volume size (DL,DM,DY,LD) 

372 Read/write handler translation table (LD) 

For RK06/07 handler (DM), special function codes 377 and 376 
require the buffer size to be one word larger than necessary for 
the data. The first word of the buffer contains the error informa¬ 
tion returned as a result of the .SPFUN request. Error codes and 
meanings are as follows: 

100000 The I/O operation is successful. 

100001 An ECC error is corrected. 

100002 An error recovered on retry. 

100004 An error recovered through an offset retry. 
100010 An error recovered after recalibration. 

100200 A bad block was detected (BSE error). 

1774xx An error did not recover. 
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.SPND 


EMT 374, Code 1 


(FB and XM Only) 


This request suspends the mainline program and allows only 
completion routines for I/O and mark time requests to run. 


Call: .SPND 

Errors: 


None 


.SRESET EMT 352 

This request, software reset, performs the following functions: 

Cancels any messages sent by the job 
Waits for all I/O to complete 
Dismisses any device handlers FETCHed 
Purges any currently open files 
Reverts to 16(decimal) I/O channels 
Clears the job’s .SPND/.RSUMM counter 
Resets the I/O queue to one element 
Cancels all outstanding .MRKT requests 

Call: .SRESET 

Errors: 

None 
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.SYNCH 


Macro Expansion 


This macro enables a program to issue programmed requests 
from within an interrupt service routine. Code following the 
.SYNCH call runs at priority level 0 as a completion routine in the 
issuing job’s context. 

Call: .SYNCH area [,pic] 

area is the address of a 7-word block for use by 
.SYNCH. 

pic is an optional argument which, if not blank, 
causes the .SYNCH macro to produce posi¬ 
tion-independent code. 

Errors: 

None 

SYNCH Block Format: 

Offset Contents 

0 Maintained by the monitor, do not alter 
2 Current job number; must be set by pro¬ 

gram prior to issuing the .SYNCH 
4 Reserved 

6 Reserved 

10 Synch ID 

12 -1 

14 0 

The .SYNCH macro issues a subroutine call to the monitor and 
does not use an EMT request. Nothing may be placed on the 
stack between the .INTEN and .SYNCH calls. Normal return is to 
the word after the error return. R0 contains the Synch ID that 
was in word 5 of the block. R0 and R1 are free for use. 
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.TIMIO 


Macro Expansion 


This macro issues a device time-out call in a device handler I/O 
initiation section. This request schedules a completion routine to 
run after the specified time interval has elapsed. The completion 
routine runs in the context of the job indicated in the timer block. 

Call: .TIMIO tblk, hi, lo 

tblk is the address of a 7-word timer block. 

hi is the high-order time interval. 

lo is the low-order time interval. 

Errors: 

None 

Timer block format: 

Offset Contents 

0 High-order time word 

2 Low-order time word 

4 Link to next queue element; 0 indicates 

none 

6 Owner’s job number; 0 for background job, 
MAXJOB for foreground job, and (job prior¬ 
ity) *2 for system jobs 

10 Sequence number of timer request; valid 
range of sequence numbers is 177000 to 
177377 

12 -1 

14 Address of the completion routine to exe¬ 
cute if time-out occurs: the monitor zeroes 
this word when the completion routine is 
called, indicating that the timer block is 
available for reuse. When the completion 
routine is entered, R0 contains the se¬ 
quence number of the request that timed- 
out. 
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.TLOCK 


EMT 374, Code 7 


This request is used in an FB environment to gain ownership of 
the USR. The .TLOCK request is similar to the .LOCK request in 
that if successful, the user job returns with the USR in memory 
(identical to .LOCK in the SJ monitor). With .TLOCK, if the USR 
is not available, control returns immediately with the C-bit set to 
indicate the .TLOCK request failed. 

Call: .TLOCK 


Format: RO = 


Errors: 



Code Explanation 

0 USR is already in use by another job. 
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.TRPSET 


EMT 375, Code 3 


This request allows the user job to intercept traps to 4 and 10 
instead of having the job aborted with a ?MON-F-Trap to nn 
message. The carry bit determines which trap occurred: carry bit 
clear indicates a trap to 4; carry bit set indicates a trap to 10. 

Call: .TRPSET area, addr 


area is the address of a 2-word EMT argument 
block. 

addr is the address of the trap routine. If an ad¬ 
dress of 0 is specified, trap interception is 
disabled. 


Format: R0 -> 


Errors: 


3 

0 

addr 


None 
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.TTYIN/.TTINR 


EMT 340 


These requests transfer a character from the console terminal to 
the user program. The character is passed as a right-justified 
byte in RO. The operation of .TTYIN/.TTINR can be altered by 
the setting of certain bits in the JSW. The expansion of .TTYIN 
is: 

EMT 340 

BCS .-2 

The expansion of .TTINR is: 

EMT 340 

If no characters are available when an EMT 340 is executed, 
return is made with the carry bit set. 

Call: .TTYIN char 

Call: .TTINR char 

char is a pointer to a location where the charac¬ 
ter in RO is to be stored. If char is specified, 
the character is returned both in RO and the 
address pointed to by char. If char is not 
specified, the character is returned only in 
RO. 

Errors: 

Code Explanation 

0 No characters are available in the ring buffer. 


216 







.TTYOUT/.TTOUTR 


EMT 341 


These requests transfer a character to the console terminal. If 
the monitor’s output ring buffer has no room for the character, 
the .TTYOUT request waits for room before returning, but the 
.TTOUTR request returns immediately with carry set. The ex¬ 
pansion of .TTYOUT is: 

.EMT 341 

BCS .-2 

The expansion of .TTOUTR is: 

.EMT 341 

Call: .TTYOUT char 

Call: .TTOUTR char 

char is the location containing the character to be 
loaded into RO and printed. If not specified, 
the character in RO is printed. Upon return 
from the request, RO still contains the char¬ 
acter. 

Errors: 

Code Explanation 

0 Output ring buffer is full. 
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.TWAIT 


EMT 375, Code 25 


This request suspends the user’s job for an indicated length of 
time. This request requires a queue element. 

Call: .TWAIT area, time 

area is the address of a 2-word EMT argument 
block. 

time is a pointer to 2 words of time (high-order 
first, low-order second), expressed in ticks 
past midnight. 

Format: RO -> - 


24 


0 


time 


Errors: 


Code 


0 


Explanation 

No queue element was available. 
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.UNLOCK 


EMT 347 


This request releases the USR from memory if it was placed 
there with a .LOCK request. If the .LOCK required a swap, the 
.UNLOCK loads the user program back into memory. 

Call: .UNLOCK 

Errors: 


None 


.UNMAP EMT 375, Code 36 (XM Only) 

This request unmaps a window and flags that portion of the 
program’s virtual address space as inaccessible. When an un¬ 
map operation is performed for a virtual job, attempts to access 
the unmapped address space cause a memory management 
fault. 


Call: .UNMAP area, addr 

area is the address of a 2-word argument block, 
addr is the address of the window control block 
that describes the window to be unmapped. 


Format: RO -> 


Errors: 


36 

5 

addr 


Code Explanation 

3 An invalid window identifier was specified. 

5 The specified window was not already mapped. 
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.UNPROTECT 


EMT 375, Code 31 


This request is the complement of the .PROTECT request. It 
cancels any protected vectors in the 0 to 476 area. An attempt to 
unprotect a vector that a job has not protected is ignored. 

Call: .UNPROTECT area, addr 


area is the address of a 2-word EMT argument 
block 

addr is the address of the word pair to be can¬ 
celed. The argument addr must be a multi¬ 
ple of 4 and must be less than or equal to 
474(octal). 


Format: RO -> 


Errors: 


31 

1 

addr 


Code Explanation 

1 Address is greater than 474 or not a multiple of 

4. 
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.WAIT 


EMT 374, Code 0 


This request suspends program execution until all I/O requests 
on the channel are completed. The .WAIT request is typically 
combined with the .READ and .WRITE requests to perform dou¬ 
ble buffering. 

Call: .WAIT chan 


Format: RO = 


Errors: 


0 


chan 


Code Explanation 

0 Channel specified is not open. 

1 Hardware error occurred on the previous I/O 

operation on this channel. 
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.WDBBK 


Macro Expansion 


(XM Only) 


This macro defines symbols and reserves space for the window 
definition block. Information provided to the arguments of this 
macro permits the creation and mapping of a window through 
the use of the .CRAW request. .WDBBK automatically calls 
.WDBDF. 

Call: .WDBBK wnapr, wnsiz [, wnrid, wnoff, wnlen, wnsts] 

wnapr is the number of the Active Page Register 
(APR) set that includes the window’s base 
address. A window must start on a 4K-word 
boundary. The valid range of values is 0 
through 7. 

wnsiz is the size of this window, expressed in 32- 
word units. 

wnrid is the identification for the region to which 
this window maps. 

wnoff is the offset into the region at which to start 
mapping this window, expressed in 32-word 
units. 

wnlen is the amount of this window to map, ex¬ 
pressed in 32-word units. The default value 
is 0, which maps as much of the window as 
possible. 

wnsts is the window status word. 
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.WDBDF 


Macro Expansion 


(XM Only) 


This request defines the symbolic offset names for the window 
definition block and the names for the window status word bit 
patterns. This macro also defines W.NLGH, the length of the 
window definition block. 

Call: .WDBDF 


Expansion: 

W.NID 


0 

W.NAPR 

= 

1 

W.NBAS 

= 

2 

W.NSIZ 

= 

4 

W.NRID 

= 

6 

W.NOFF 

= 

10 

W.NLEN 

= 

12 

W.NSTS 

= 

14 

W.NLGH 

= 

16 

WS.MAP 

= 

400 

WS.ELW 

= 

20000 

WS.UNM 

= 

40000 

WS.CRW 

= 

100000 
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.WRITC 


EMT 375, Code 11 


This request transfers a specified number of words from memory 
to a channel. Control returns to user program immediately after 
the request is queued. When the .WRITC completes, control 
passes to the completion routine specified in the request. 

Call: .WRITC area, chan, buf, went, ertn, blk 

area is the address of a 5-word EMT argument 
block. 

chan is a channel number in the range 0 to 
376(octal). 

buf is the address of the memory buffer to be 
used for output. 

went is the number of words to write. 

ertn is the address of the completion routine and 

must be above 500(octal). 

blk is the starting block number to write. 



Errors: 

Code Explanation 


0 Attempt was made to write past end-of-file. 

1 Hardware error occurred. 

2 Channel is not open. 


On return, RO contains the number of words transferred. This will 
be less than the number requested if the output device has in¬ 
sufficient space. 
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.WRITE 


EMT 375, Code 11 


This request transfers a specified number of words from memory 
to a channel. Control returns to user program immediately after 
the request is queued. 


Call: .WRITE area, chan, buf, went, blk 


area is the address of a 5-word EMT argument 
block. 

chan is a channel number in the range 0 to 
376(octal). 

buf is the address of the memory buffer to be 
used for output. 

went is the number of words to write, 
blk is the starting block number to write. 



Errors: 


Code Explanation 


0 Attempt was made to write past end-of-file. 

1 Hardware error occurred. 

2 Channel is not open. 

On return, RO contains the number of words transferred. This will 
be less than the number requested if the output device has in¬ 
sufficient space. 
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.WRITW 


EMT 375, Code 11 


This request transfers a specified number of words from memory 
to a channel. Execution of the job is suspended until the 
.WRITW completes. 

Call: .WRITW area, chan, buf, went, blk 

area is the address of a 5-word EMT argument 
block. 

chan is a channel number in the range 0 to 
376(octal). 

buf is the address of the memory buffer to be 
used for output. 

went is the number of words to write, 
blk is the starting block number to write. 



Errors: 

Code Explanation 

0 Attempt was made to write past end-of-file. 

1 Hardware error occurred. 

2 Channel is not open. 

On return, RO contains the number of words transferred. This will 
be less than the number requested if the output device has in¬ 
sufficient space. 
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Monitor Data Structures 


Control Blocks 


I/O Channel Block Format 


Name 

Offset 

Contents 

C.CSW 

0 

Channel status word 

C.SBLK 

2 

Starting block number of file (0 if not file 
structured) 

C.LENG 

4 

Length of file, if opened by .LOOKUP; size 
of empty area, if opened by .ENTER 

C.USED 

6 

Highest block written 

C.DEVQ 

10 

Number of pending requests (byte) 

C.UNIT 

11 

Device unit number (byte) 

Channel 

Status Word (C.CSW) Bit Definitions 

Name 

Bits 

Meaning 

HDERR$ 

1 

Hard error 

INDX$M 

76 

Index mask into $PNAME and other device 
tables 

RENAM$ 

100 

Rename operation is in progress 

D WRITS 

200 

File was opened with a .ENTER; monitor 
will modify directory when file is closed 

DBLK$M 

17400 

Mask for directory segment containing this 
entry 

EOF$ 

20000 

End-of-file found on this channel 


(14) 

Reserved 

ACTIV$ 

100000 

Channel is active 
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Handler Prefix Area Format 


The handler prefix area is contained in block 0 of each handler. 

Name 

Offset 

Contents 

H.SIZ 

52 

Size of handler in bytes 

H.DVSZ 

54 

Size of device in 256-word blocks 

H.DSTS 

56 

Default device status value 

H.GEN 

60 

Sysgen options 

H.BPTR 

62 

Pointer to primary bootstrap 

H.BLEN 

64 

Length of primary bootstrap in bytes 

H.READ 

66 

Pointer to read routine for bootstrap 

Region Control Block Format 

Name 

Offset 

Contents 

R.BADD 

0 

Starting physical address in 32-word blocks; 
0 if not in use 

R.BSIZ 

2 

Size of region in 32-word blocks 

R.BSTA 

4 

Region status (byte) 

R.BNWD 

5 

Number of windows mapped to region 
(byte) 

Region Status Byte (R.BSTA) Bit Definitions 

Name 

Bits 

Meaning 

R.STOP 

1 

Region created by .SETTOP 

Region Descriptor Block Format 

Name 

Offset 

Contents 

R.GID 

0 

Region ID returned by system 

R.GSIZ 

2 

Size of region in 32-word blocks 

R.GSTS 

4 

Region status word 
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Region Status Word (R.GSTS) Bit Definitions 


Name 


Bits Meaning 


( 0 - 12 ) 

• RS.NAL 20000 
RS.UNM 40000 
RS.CRR 100000 


Reserved 

Region was not previously allocated 
One or more windows were unmapped 
Region was successfully created 


Window Control Block Format 


Name Offset Contents 


W.BRCB 


W.BLVR 

• W.BHVR 
W.BSIZ 


W.BOFF 

• W.BFPD 
W.BNPD 
W.BLPD 


0 Pointer to region control block of region to 
which window is mapped 
2 Low virtual address limit 

4 High virtual address limit 

6 Size of window in 32-word blocks; 0 if not in 
use 

10 Offset into region in 32-word blocks 

12 First PDR in window (byte) 

13 Number of PDR’s in window (byte) 

14 Contents of last PDR 


Window 


Definition Block Format 


Name Offset Contents 


W.NID 

W.NAPR 

W.NBAS 

W.NSIZ 

W.NRID 

W.NOFF 

W.NLEN 

W.NSTS 


0 Window identifier (byte) 

1 Base PAR for window (byte) 

2 Virtual base address 

4 Window size in 32-word blocks 
6 Region identifier 
10 Offset into region in 32-word blocks 
12 Length of window to map 
14 Window status word 
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Window Status Word (W.NSTS) Bit Definitions: 


Name 

Bits 

Meaning 


(0-7) 

Reserved 

WS.MAP 

400 

Map window after creating it 


(9-12) 

Reserved 

WS.ELW 

20000 

One or more windows were eliminated 

WS.UNM 

40000 

One or more windows were unmapped 

WS.CRW 100000 

Window successfully created 

System Communications Area (SYSCOM) 

Name 

Address 

Contents 

USERPC 

40 

Start address of job 

USERSP 

42 

Initial value of the stack pointer; default is 
1000 

JSW 

44 

Job Status Word 

U FLOAT 

46 

USR load address 

USERTO 

50 

High memory address of the user program 

ERRBYT 

52 

EMT error reporting byte 

USERRB 

53 

User program error reporting byte 

SYSPTR 

54 

Address of the beginning of the Resident 
Monitor 

TTFILL 

56 

Fill character 

TTNFIL 

57 

Fill count 


230 





JSW Bit Definitions 


Name 

Bits 

Meaning 


(0-2) 

Reserved 

GTLIN$ 

10 

Non-terminating .GTLIN bit 

EDITS 

20 

If set, turns off single-line editor 

SPXIT$ 

40 

Special chain exit 

TCBITS 

100 

FB, XM; Inhibit terminal wait bit 

HLTER 

200 

SJ; I/O Error halt 

CHAINS 

400 

CHAIN bit 

OVLYS 

1000 

Overlaid program 

VIRTS 

2000 

XM; Virtual image bit 

CHNIFS 

4000 

Pass line to KMON bit 

TTSPCS 

10000 

Special mode terminal bit 

RSTRTS 

20000 

Reenter bit for programs 

TTLCS 

40000 

Lowercase bit for console 

USWAP$ 100000 

SJ; USR swap bit 

USERRB Bit Definitions 

Name 

Bits 

Meaning 

succss 

1 

No error 

WARNS 

2 

Warning 

ERRORS 

4 

Error 

SEVERS 

10 

Severe error 

FATALS 

20 

Fatal error 





Disk and File Formats 

Block-Replaceable Device Directory Structure 

Header: 


Name 

Offset 

Contents 

D.TOTA 

0 

Total number of segments in this direc¬ 
tory; the valid range is 1 to 31 (decimal) 

D.NEXT 

2 

The segment number of the next logical 
directory segment; 0 if none 

D.HIGH 

4 

The number of the highest segment cur¬ 
rently in use; only maintained in first di¬ 
rectory segment 

D.EXTR 

6 

The number of extra bytes per directory 
entry; always an unsigned, even octal 
number 

D.STRT 

10 

The block number on the device where 
the actual stored data monitored by this 
segment begins 

Directory Entry: 


Name 

Offset 

Contents 


0 

Entry status word 

E.NAME 

2 

File name; three words of Radix-50 

E.LENG 

10 

Size in blocks of file, or size of free area 
if unused or tentative 

E.USED 

12 

Unused on disk for permanent files; in 
memory, highest block written 

E.CHAN 

12 

Channel number of tentative entry (byte) 

E.JNUM 

13 

FB, XM; Job number of tentative entry 
(byte) 

E.DATE 

14 

Creation date 


16 + 

Extra words, if any 
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Entry Status Word (Bit Definitions): 


Name 

Bits Meaning 

TENT 

EMPTY 

(0-7) Reserved 

400 Tentative entry 

1000 Empty entry 


PERM 2000 Permanent entry 
ENDBLK 4000 End of segment 
(12-14) Reserved 

PROT 100000 Protected entry (only if permanent) 

Home Block Contents 


Offset 

Contents 

000-201 
r\ 204-251 

252-273 
700-701 
702-703 
722-723 
724-725 
726-727 
730-743 
^ 744-757 

760-773 
776-777 

Bad block replacement table 
INITIALIZE/RESTORE data area 

BUP information area 

Reserved 

Block number of first user file; always 0 

Pack cluster size; always 1 

Block number of first directory segment; always 6 
System version in Radix-50 

Volume identification 

Owner name 

System identification 

Checksum 


Bad Block Replacement Table Entries 


| Offset 

Contents 

0 

2 

Bad block number; 0 if end of table 

Replacement block number 
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SAV Image File Format (Block 0) 

Offset Contents 

0 .RAD50 /VIR/ for virtual overlaid files 
2 Virtual high limit for virtual overlaid files 
4 Reserved 

6 Reserved 

10 Reserved 

12 Reserved 

14 XM only; BPT trap 

16 XM only; BPT trap 

20 XM only; IOT trap 

22 XM only; IOT trap 

24 Reserved 

26 Reserved 

30 Reserved 

32 Reserved 

34 Trap vector (TRAP) 

36 Trap vector (TRAP) 

40 Relative start address 

42 Initial stack pointer 

44 Job Status Word (JSW) 

46 USR swap address 

50 Program’s high limit 

52 Size of root segment; used for .REL files only 
54 Stack size in bytes; used for .REL files only 
56 Size of overlay region; used for .REL files only 
60 .RAD50 /REL/; used for .REL files only 

62 Relative block of start of relocation information; 

used for .REL files only 

64 Address of overlay handler table for overlaid files 
66 Address of start of window definition blocks, for 

virtual overlaid files 
70-356 Reserved 

360-377 Memory usage bitmap 
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RMON Fixed Offsets 


Name 

Offset 

Contents 

$RMON 

0 

Common interrupt entry point 

$CSW 

4 

Background job channel area; ^(deci¬ 
mal) channels at 5 words per channel 

$SYSCH 

244 

Internal channel for system functions 


246 

SJ; Reserved 


250 

SJ; Reserved 

I.SERR 

252 

SJ; Hard/soft error indicator 

I.SPLS 

252 

SJ; Hard/soft error indicator 


254 

SJ; Reserved 

BLKEY 

256 

Directory segment number in memory 

CHKEY 

260 

Device index and unit number of direc¬ 
tory in memory 

$DATE 

262 

Current date value 

DFLG 

264 

Directory operation in progress flag 

$USRLC 

266 

Address of the normal USR area 

QCOMP 

270 

Address of the I/O exit routine for all de¬ 
vices 

SPUSR 

272 

Special device error word 

SYUNIT 

274 

Unit number of system device (high 
byte) 

SYSVER 

276 

Monitor version number (byte) 

SYSUPD 

277 

Monitor release level (byte) 

CONFIG 

300 

Configuration word 

SCROLL 

302 

Address of VT11 scroller 

TTKS 

304 

Address of the console keyboard status 
register 

TTKB 

306 

Address of the console keyboard buffer 
register 

TTPS 

310 

Address of the console printer status 
register 

TTPB 

312 

Address of the console printer buffer 
register 

MAXBLK 

314 

Maximum file size allowed in a 0 length 
.ENTER 
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RMON Fixed Offsets (cont.) 


Name 

Offset 

Contents 

E16LST 

316 

Offset from start of RMON to EMT 
dispatch table 

$TIME 

320 

SJ; high-order time-of-day 


322 

SJ; low-order time-of-day 

CNTXT 

320 

FB, XM; Pointer to current job’s impure 
area 

JOBNUM 

322 

FB, XM; Current job’s number 

SYNCH 

324 

.SYNCH routine address 

LOWMAP 

326 

Low memory protection bitmap 

USRLOC 

352 

USR entry pointer 

GTVECT 

354 

Address of display stop interrupt vector 
of VT11 or VS60 display processor; de¬ 
fault is 320 

ERRCNT 

356 

Low byte is error count byte used by 
system utility programs 

$MTPS 

360 

Entry point of the move to PS routine 

$MFPS 

362 

Entry point of the move from PS routine 

SYINDX 

364 

Index into monitor device tables for sys¬ 
tem device 

STATWD 

366 

Indirect file and monitor command status 
word 

CONFG2 

370 

Extension configuration word 

SYSGEN 

372 

System generation features word 

USRARE 

374 

Size of USR in bytes 

ERRLEV 

376 

Error severity at which to abort indirect 
files 

IFMXNS 

377 

Depth of nesting of indirect file 

EMTRTN 

400 

Internal offset for use by BATCH only 

FORK 

402 

Offset to fork processor 

PNPTR 

404 

Offset to $PNAME table from the start of 
RMON 

MONAME 

406 

Two words of Radix-50 containing the 
name of current monitor file 
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RMON Fixed Offsets (cont.) 


Name 

Offset 

Contents 

SUFFIX 

412 

One word of Radix-50 containing the 
suffix used by the current monitor to 
name device handlers; normally blank 
for SJ and FB, contains X, right-justified, 
in XM 

DECNET 

414 

Reserved for DECnet 

EXTIND 

416 

IND stored error byte 

INDSTA 

417 

IND control status byte 

$MEMSZ 

420 

Total physical memory available, in 32- 
word units 


422 

Reserved 

$TCFIG 

424 

Address of terminal SET option status 
word 

$INDDV 

426 

Pointer to ASCII device name and unit 
number of IND.SAV 

MEMPTR 

430 

Offset to memory control block pointers 

PI EXT 

432 

Address of PARI externalization routine; 
XM only, 0 in SJ and FB 
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Configuration Word (RMON fixed offset 300) 


Name 

Bits 

Meaning 

FBMON$ 

1 

FB or XM monitor; check KT11$ 

SLKMO$ 

2 

If set, KMON fetches SL handler and 
uses single-line editor 

HWDSP$ 

4 

VT11 or VS60 graphics display 

BATCH$ 

10 

BATCH is in control 

SLEDI$ 

20 

If set, single-line editor is available for 
use by user programs 

CLK50$ 

40 

50-cycle clock 

HWFPU$ 

100 

FP11 floating-point hardware 

FJOB$ 

200 

Foreground or system job is in memory 

GTLNK$ 

400 

User is linked to graphics scroller 

USR$ 

1000 

USR is permanently resident 

QUEUES 

2000 

The QUEUE program is running 

LSI11S 

4000 

Processor is PDP-11/03 

KT11$ 

10000 

A mapped system is running under the 
XM monitor 

LKCS$ 

20000 

The system clock has a status register 

KW11 P$ 

40000 

A KW11-P clock exists 

CLOCKS 

100000 

There is a system clock; L-clock, P- 
clock, or 11/03,23 line-frequency clock 
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DCL/@file Status Word (RMON fixed offset 366) 


Name 


Bits Meaning 


IFLIF 1 

• IFLEOF 2 

IFIND 4 


IFDOL 

IFSPCD 

IFBEXT 

IFRVTT 

IFGTCC 


10 

20 

40 

100 

200 


IFACTV 

IFCHAI 

IFEKO$ 

IFCTLC 


400 

1000 

2000 

4000 


IFDAT 


10000 


IFEOF$ 

IFABRT 

IFINP 




20000 

40000 

100000 


Doing link overlay indirect file 
EOF in link overlay indirect file 
0 = Use KMON to interpret indirect 
command files 

1 = Use IND.SAV to interpret indirect 
command files 

Dollar sign entered at command line 
Special chain exit 

BATCH forcing exit after user job error 

Revert to TTY input from indirect file 

ffiE) seen in indirect file while GTLIN$ 

bit set in JSW 

Indirect file active 

Chain to indirect file 

Don’t echo indirect file lines 

SJ; double ( Ctrl/c ) typed 

FB; (cjr l /c j seen in indirect file 

Data in DCLS/indirect file buffer above 

KMON/USR 

EOF in DCLS/indirect file 
Abort DCLS/indirect file 
DCLS/indirect file input 
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Configuration Word 2 (RMON fixed offset 370) 


Name 

Bits 

Meaning 

CACHES 

1 

Cache memory is present 

MPTY$ 

2 

Parity memory is present 

SWREGS 

4 

A readable switch register is present 

LIGHTS 

10 

A writable console display register is 
present 

LDRELS 

20 

LD handler LOAD status 

XITSWS 

40 

User code swap/noswap flag 


(6) 

Reserved 

CISS 

200 

Commercial instruction set (CIS) option 
is present 

EISS 

400 

Extended instruction set (EIS) option is 
present 

VS6S0 

1000 

VS60 hardware; check offset 300, bit 2 


(10-13) 

Reserved 

PDP70S 

40000 

Processor is a PDP-11/70 

PDP60S 

100000 

Processor is a PDP-11/60 


Sysgen Features Word (RMON fixed offset 372) 


Name Bits Meaning 


ERLG$ 

1 

MMGT$ 

2 

TIMIT$ 

4 

RTEM$ 

10 

(4-8) 

MPTY$ 

1000 

TIMERS 

2000 

(11-12) 

MTTY$ 

20000 

STASK$ 

40000 

(15) 


Error Logging support 
Memory Management support 
Device time-out support 
RTEM monitor 
Reserved 

Memory parity support 
SJ mark time 
Reserved 

Multiterminal support 
System job support 
Reserved 
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IND Control 

Status Byte (RMON Fixed Offset 417) 

Name 

Bits 

Meaning 

LN$IND 

40 

Set if current line passed by IND 

IN$RUN 

100 

Set if KMON issued RUN of IND 

IN$IND 

200 

Set if IND active 
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Queue Elements 

Completion Queue Element Format 


Name Offset Contents 


Q.LINK 

Q.BUFF 

Q.WCNT 

Q.COMP 


0 

2 

4 

6 

10 

12 

14 

16 


Link to next queue element; 0 if none 

Reserved 

Reserved 

Reserved 

Channel status word 

Offset from start of channel area to this 

channel 

Completion routine address 

XM; three additional reserved words 


Fork Queue Element Format 


Name Offset Contents 


F.BLNK 

F.BADR 

F.BR5 

F.BR4 


0 Link to next queue element; 0 if none 

2 Fork routine address 

4 R5 save area 

6 R4 save area 
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I/O Queue Element Format 


Name 

Offset 

Contents 

Q.LINK 

0 

Link to next queue element; 0 if none 

Q.CSW 

2 

Pointer to channel status word in I/O 
channel block 

Q.BLKN 

4 

Physical block number 

Q.FUNC 

6 

Special function code (byte) 

Q.UNIT 

7 

Device unit number, bits 0 through 2 

Q.JNUM 

7 

Job number, bits 3 through 6 

Q.BUFF 

10 

User buffer address; mapped through 
PARI with Q.PAR value, if XM 

Q.WCNT 

12 

Word count: 
negative = write 

0 = seek 

positive = read 

Transfer count is absolute value of this 
word 

Q.COMP 

14 

Completion routine code: 

0 = wait-mode I/O 

1 = request is queued and return is 
made to caller 

even number = address of completion 
routine 

Q.PAR 

16 

XM; PARI displacement bias 

Q.FREE 

20 

XM; two additional reserved words 
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Synch Queue Element Format 


Name 

Offset 

Contents 

Q.LINK 

0 

Link to next queue element; 0 if none 

Q.CSW 

2 

Job number 


4 

Reserved 


6 

Reserved 

Q.BUFF 

10 

Synch ID 

Q.WCNT 

12 

-1 (indicator that this is a Synch ele¬ 
ment) 

Q.COMP 

14 

Synch routine address 


16 

XM; three additional reserved words 

Timer Queue Element Format 

Name 

Offset 

Contents 

C.HOT 

0 

High-order expiration time 

C.LOT 

2 

Low-order expiration time 

C.LINK 

4 

Link to next queue element; 0 if none 

C.JNUM 

6 

Owner’s job number 

C.SEQ 

10 

Owner’s sequence number ID 

C.SYS 

12 

-1 if system timer element; 

-3 if .TWAIT element in XM 

C.COMP 

14 

Address of completion routine 
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System Subroutine Library 
(SYSLIB.OBJ) 

Routines in the system subroutine library can be called by either 
a FORTRAN or MACRO program. To call a SYSLIB routine from 
a MACRO program, R5 must contain the address of an argu¬ 
ment block, which in turn contains the address of each subrou¬ 
tine argument. The general format looks like this: 


.GLOBL 

subr .Subroutine name is 

;global reference 

MOV 

#ARGBLK, R5 

JSR 

PC, subr 


ARGBLK: .BYTE 

n 

;Number of arguments 

.BYTE 

0 

.Reserved 

.WORD 

argl 

;Address of argument 1 

.WORD 

arg2 

;Address of argument 2 

.WORD 

argn 

;Address of argument n 


The FORTRAN statement syntax for calling each SYSLIB rou¬ 
tine is given in this section. 
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File-Oriented Operations 


CLOSEC CALL CLOSEC (chan[,i]) 
i = CLOSEC (chan) 

Closes the specified channel 

ICLOSE CALL ICLOSE (chan[,i]) 
i = ICLOSE (chan) 

Closes the specified channel 

IDELET i = IDELET (chan,dblk[,seqnum]) 

Deletes the file from the specified device 

ENTER i = ENTER (chan,dblk,length[,seqnum]) 

Creates a new file for output 

IFPROT i = IFPROT (chan,filespec,prot) 

Sets or removes file protection 

IRENAM i = IRENAM (chan,dblk) 

Changes the name of the indicated file to a new name 

ISFDAT i = ISFDAT (chan,dblk,idate) 

Changes the date in a file’s directory entry 

LOOKUP i = LOOKUP (chan,dblk[,count,seqnum,], 
[jobdes]) 

Opens an existing file for I/O with the specified channel 


Data Transfer Functions 

IRCVD i = IRCVD (buff,went) 

Receives data and returns to user program immediately 

IRCVDC i = IRCVDC (buff,went,ertn) 

Receives data and enters an assembly language completion 
routine 

IRCVDF i = IRCVDF (buff,went,area,ertn) 

Receives data and enters a FORTRAN subprogram 
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IRCVDW i = IRCVDW (buff,went) 

Receives data, waits for completion, and returns to the user 
program 

IREAD i = IREAD (went,buff,blk,chan) 

Transfers data on the specified channel to a memory buffer 
and returns control to the user program 

IREADC i = IREADC (went,buff,blk,chan,ertn) 

Transfers data on the specified channel to a memory buffer 
and enters an assembly language completion routine 

IREADF i = IREADF (went,buff,blk,chan,area,ertn) 

Transfers data on the specified channel to a memory buffer 
and enters a FORTRAN subprogram 

IREADW i = IREADW (went,buff,blk,chan) 

Transfers data on the specified channel to a memory buffer 
and returns control to the user program only after the transfer 
is complete 

ISDAT i = ISDAT (buff,went) 

Transfers the specified number of words from one job to the 
other and returns control immediately to the user program 

ISDATC i = ISDATC (buff,went,ertn) 

Transfers the specified number of words from one job to the 
other and returns control to the user program immediately 

ISDATF i = ISDATF (buff,went,area,ertn) 

Transfers the specified number of words from one job to the 
other and enters a FORTRAN subprogram 

ISDATW i ± ISDATW (buff,went) 

Transfers the specified number of words from one job to the 
other and returns control to the user program only after the 
transfer is complete 

ITTINR i = ITTINR () 

Inputs one character from the console terminal 
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ISPFNC i = ISPFNC (code,chan,went,buff,blk.crtn) 

Queues the specified operation and enters an assembly lan¬ 
guage completion routine 

ISPFNF i = ISPFNF (code,chan,went,buff,blk,area,ertn) 

Queues the specified operation and enters a FORTRAN sub¬ 
program 

ISPFNW i = ISPFNW (code,chan[,went,buff,blk]) 

Queues the specified operation and returns control to the 
user program only after the operation completes 

ITLOCK i = ITLOCK () 

Indicates whether the USR is currently in use by another job 
and performs a LOCK if possible 

LOCK CALL LOCK 

Makes the RT-11 monitor USR permanently resident until an 
UNLOCK is executed 

RCHAIN CALL RCHAIN (flag,var,went) 

Allows a program to access variables passed across a chain 

RCTRLO CALL RCTRLO 

Enables output to the terminal by canceling the effect of a 
previously typed CTRL/O, if any 

RESUME CALL RESUME 

Causes the mainline execution of a job to resume after it was 
suspended with a SUSPND call 

SCCA CALL SCCA [(iflag)] 

Inhibits a CTRL/C abort; indicates that a CTRL/C is active; 
distinguishes between a single and double CTRL/C 

SETCMD CALL SETCMD (string) 

Allows a user program to pass a command line to the key¬ 
board monitor to be executed after the program exits 
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SUSPND CALL SUSPND 

Suspends mainline execution of the running job; completion 
routines continue to run 

UNLOCK CALL UNLOCK 

Releases the USR if a LOCK was performed 

INTEGERM Support Functions 

AJFLT a = AJFLT (jsrc) 

Converts the specified INTEGERS value to REALM and re¬ 
turns the result as a function value 

DJFLT d = DJFLT (jsrc) 

Converts the specified INTEGERM value to REAL*8 and re¬ 
turns the result as a function value 

IAJFLT i = IAJFLT (jsrc,ares) 

Converts the specified INTEGERS value to REALM and 
stores the result 

IDJFLT i = IDJFLT Gsrc.dres) 

Converts the specified INTEGERM value to REAL*8 and 
stores the result 

IJCVT i = IJCVT (jsrc[,iresj) 

Converts the specified INTEGERM value to INTEGERS 

JADD i=JADD Goprl ,jopr2,ires) 

Computes the sum of two INTEGERM values 

JAFIX i = JAFIX (asrcjres) 

Converts a REALM value to INTEGERM 

JCMP i = JCMP Gopr1,jopr2) 

Compares two INTEGERM values and returns an INTE- 
GER*2 value that reflects the signed comparison result 
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JDFIX i = JDFIX (dsrcjres) 

Converts a REAL*8 value to INTEGERM 

JDIV i = JDIV (joprl ,jopr2,jres[,jrem]) 

Computes the quotient of two INTEGER*4 values 

JICVT i = JICVT (isrcjres) 

Converts an INTEGERS value to INTEGERM 

JJCVT CALL JJCVT Gsrc) 

Converts 2-word internal time formats to INTEGERS format, 
and vice versa 

JMOV i = JMOV Gsrc.jdest) 

Assigns an INTEGERS value to a variable 

JMUL i = JMUL Goprl ,jopr2,jres) 

Computes the product of two INTEGERM values 

JSUB i = JSUB Goprl ,jopr2,jres) 

Computes the difference between two INTEGERM values 


Character String Functions 

CONCAT CALL CONCAT (a,b,out[,len[,err]]) 

Concatenates two variable-length strings 

GETSTR CALL GETSTR (lun,out,len,err) 

Reads a character string from a specified FORTRAN logical 
unit 

GTLIN CALL GTLIN (result[,prompt]) 

Transfers a line of input from the terminal or an indirect file to 
the user program 

INDEX CALL INDEX (a,pattrn[,i],m) 
m = INDEX (a,pattrn[,i]) 

Returns in m the starting location of string pattern occurring 
in string source, following location i 
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INSERT CALL INSERT (in,out,i[,m]) 

Inserts a string at a specified position in another string 

LEN i = LEN (a) 

Returns the number of characters in string a 

PUTSTR CALL PUTSTR (lun,in,char,err) 

Writes a variable-length character string to a specified FOR¬ 
TRAN logical unit 

REPEAT CALL REPEAT (in,out,i[,len[,err]]) 

Concatenates a specified string with itself to produce an indi¬ 
cated number of copies, and stores the resultant string in an 
array 

SCOMP CALL SCOMP (a,b,i) 
i = SCOMP (a,b) 

Compares two character strings and returns the integer re¬ 
sult of the comparison 

SCOPY CALL SCOPY (in,out,[,len[,err]]) 

Copies a character string from one array to another 

STRPAD CALL STRPAD (a,len,[,err]) 

Pads a variable-length string on the right with blanks to cre¬ 
ate a new string of a specified length 

SUBSTR CALL SUBSTR (in,out,i[,len]) 

Copies a substring from a specified string 

TRANSL CALL TRANSL (in,out,r[,p]) 

Replaces one string with another after performing character 
modification 

TRIM CALL TRIM (a) 

Removes trailing blanks from a character string 

VERIFY CALL VERIFY (a,b,i) 

IVRIF i = IVRIF (a,b) 

Determines whether each character of a specified string oc¬ 
curs anywhere in another string 
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Radix-50 Conversion Operations 

IRAD50 n = IRAD50 (icnt,input,output) 

Converts ASCII characters to Radix-50 and returns the num¬ 
ber of characters converted 

R50ASC CALL R50ASC (icnt,input,output) 

Converts Radix-50 characters to ASCII 

RAD50 a = RAD50 (input) 

Converts six ASCII characters and returns a REAL*4 result 
that is the 2-word Radix-50 value 


Multiterminal Operations 

MTATCH (unit[,addr,],[jobnum]) 

Attaches a specific terminal 

MTDTCH (unit) 

Detaches a specific terminal 

MTGET i = MTGET (unit,addr[,jobnum]) 

Gets status information about a specific terminal in a multiter¬ 
minal system 

MTIN i = MTIN (unit,char[,chrcnt,ocnt]) 

Transfers a character from a specific terminal to the user 
program 

MTOUT i = MTOUT (unit,char[,chrcnt,ocnt]) 

Transfers a character to a specific terminal 

MTPRNT (unit,string) 

Outputs an ASCII string to a specific terminal 
MTRCTO (unit) 

Resets CTRL/O for a specific terminal 

MTSET i = MTSET (unit,addr) 

Sets status information for a specific terminal 
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MTSTAT (addr) 

Returns multiterminal system status in an 8-word status 
block 


Miscellaneous Services 

IADDR i = IADDR (arg) 

Obtains the 16-bit absolute memory address of the specified 
argument 

IGETSP i = IGETSP (min,max,iaddr) 

Gets the address and size of some free space from the FOR¬ 
TRAN system 

INTSET i = INTSET (vect,pri,id,crtn) 

Establishes a specific FORTRAN subroutine as an interrupt 
completion routine at a specified priority 

IPEEK i = IPEEK (iaddr) 

Returns the contents of the word located at the specified 
absolute 16-bit memory address 

IPEEKB i = IPEEKB (iaddr) 

Returns the contents of the byte located at a specified abso¬ 
lute memory byte address 

IPOKE CALL I POKE (iaddr,ivalue) 

Stores a specified 16-bit integer value into a specified abso¬ 
lute memory location 

IPOKEB i = IPOKEB (iaddr,ivalue) 

Stores a specified 8-bit integer value into a specified byte 
location 

IPUT i = IPUT (ioff,value) 

Changes the contents of a monitor fixed offset 

ISPY i = ISPY (ioff) 

Returns the integer value of the word at a specified offset 
from the RT-11 resident monitor 
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ITTOUR i = ITTOUR (char) 

Transfers one character to the console terminal 

IWAIT i = IWAIT (chan) 

Waits for completion of all I/O on the specified channel; com¬ 
pletion routines continue to run 

IWRITC i = IWRITC (went,buff,blk,chan,crtn) 

Transfers data on the specified channel to a device and en¬ 
ters an assembly language completion routine 

IWRITE i = IWRITE (went,buff,blk,chan) 

Transfers data on the specified channel to a device and re¬ 
turns control to the user program immediately 

IWRITF i = IWRITF (went,buff,blk,chan,area,ertn) 

Transfers data on the specified channel to a device and en¬ 
ters a FORTRAN subprogram 

IWRITW i = IWRITW (went,buff,blk,chan) 

Transfers data on the specified channel to a device and re¬ 
turns control to the user program only after the transfer is 
complete 

MWAIT CALL MWAIT 

Waits for messages to be processed 

PRINT CALL PRINT (string) 

Outputs an ASCII string to the terminal 


Channel-Oriented Operations 

IABTIO CALL IABTIO (chan) 

Aborts I/O on a specified channel 

ICDFN i = ICDFN (num[,area]) 

Defines additional channels for I/O 

ICHCPY i = ICHCPY (chan,ochan[,jobblk]) 

Allows access to files currently open in the other job’s envi¬ 
ronment 
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ICSTAT i = ICSTAT (chan,addr) 

Returns the status of a specified channel 

IFREEC i = IFREEC (chan) 

Returns the specified RT-11 channel to the available pool of 
channels for the FORTRAN I/O system 

IGETC i = IGETC () 

Allocates an RT-11 channel and marks it in use for the FOR¬ 
TRAN I/O system 

ILUN i = ILUN (lun) 

Returns the RT-11 channel number with which the FOR¬ 
TRAN logical unit is associated 

IREOPN i = IREOPN (chan.cblk) 

Restores the parameters stored with an ISAVES function and 
reopens the channel for I/O 

ISAVES i = ISAVES (chan.cblk) 

Stores five words of channel status information into an array 

PURGE CALL PURGE (chan) 

Deactivates a channel without performing an ISAVES or 
CLOSEC; tentative files are lost 


Device and File Specifications 

IASIGN i = IASIGN (lun,idev[,ifiltyp[,isize[,itype]]]) 

Sets information in the FORTRAN logical unit table 

ICSI i = ICSI (filspc,deftyp[,cstring],[option],n) 

Calls the RT-11 CSI in special mode to decode file specifica¬ 
tions and options 


Timer Support Operations 

CVTTIM CALL CVTTIM (time,hrs,min,sec,tick) 

Converts a 2-word internal format time to hours, minutes, 
seconds, and ticks 
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GTIM CALL GTIM (itime) 

Gets time of day 

ICMKT i = ICMKT (id,time) 

Cancels an unexpired mark time request 

ISCHED i = ISCHED (hrs,min,sec,tick,area,id,crtn) 

Schedules the specified FORTRAN subroutine to be entered 
at the specified time of day as an asynchronous completion 
routine 

ISDTTM CALL ISDTTM (date,hitime,lotime) 

Changes the system date and time 

ISLEEP i = ISLEEP (hrs,min,sec,tick) 

Suspends mainline execution of the running job for a speci¬ 
fied amount of time; completion routines continue to run 

ITIMER i = ITIMER (hrs,min,sec,tick,area,id,crtn) 

Schedules the specified FORTRAN subroutine to be entered 
as an asynchronous completion routine when the interval 
specified has elapsed 

ITWAIT i = ITWAIT (time) 

Suspends the running job for a specified amount of time; 
completion routines continue to run 

IUNTIL i = IUNTIL (hrs,min,sec,tick) 

Suspends the mainline execution of the running job until a 
specified time of day; completion routines continue to run 

JTIME CALL JTIME (hrs,min,sec,tick,time) 

Converts hours, minutes, seconds, and ticks into 2-word in¬ 
ternal format time 

MRKT i = MRKT (id,crtn,time) 

Schedules an asynchronous routine to be entered after a 
specified interval 

SECNDS a = SECNDS (atime) 

Returns the current system time in seconds past midnight 
minus a specified time 
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TIMASC CALL TIMASC (itime.strng) 

Converts a specified 2-word internal format time into an 8- 
character ASCII string 

TIME CALL TIME (strng) 

Returns the current system time of day as an 8-character 
ASCII string 


RT-11 Services 

CHAIN CALL CHAIN (dblk,var,wcnt) 

Chains to another program (in the background job only) 

DEVICE CALL DEVICE (illst[ f link]) 

Specifies actions to be taken on normal or abnormal program 
termination 

GTJB CALL GTJB (addr[,ij) 
i = GTJB (addr) 

Returns the parameters of this job 

IGTJB CALL IGTJB (addr,i) 
i = IGTJB (addr) 

Returns the parameters of the job 

IDSTAT i = IDSTAT (devnam,cblk) 

Returns the status of the specified device 

FETCH i = IFETCH (devnam) 

Loads device handlers into memory 

IQSET i = IQSET (qleng[,areaj) 

Expands the size of the RT-11 monitor queue from the free 
space managed by the FORTRAN system 

ISPFN i = ISPFN (code,chan[,went,buff,blk]) 

Queues the specified operation and returns control to the 
user program immediately 
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Standard References 


ASCII Character Set, Left/Right Byte 
Equivalents 000-177 


Left 

Right 

ASCII 

Right 

Left 

Right 

ASCII 

Right 

Byte 

Octal 

Byte 

Octal 

Char 

Byte 

Decimal 

Byte 

1 Octal 

Byte 

Octal 

Char 

Byte 

Decimal 

000000 

000 

NUL 

0 

020000 

040 

SP 

32 

000400 

001 

SOH 

1 

020400 

041 

! 

33 

001000 

002 

STX 

2 

021000 

042 

“ 

34 

001400 

003 

ETX 

3 

021400 

043 

# 

35 

002000 

004 

EOT 

4 

022000 

044 

$ 

36 

002400 

005 

ENQ 

5 

022400 

045 

% 

37 

003000 

006 

ACK 

6 

023000 

046 

& 

38 

003400 

007 

BEL 

7 

023400 

047 

’ 

39 

004000 

010 

BS 

8 

024000 

050 

( 

40 

004400 

011 

HT 

9 

024400 

051 

) 

41 

005000 

012 

LF 

10 

025000 

052 


42 

005400 

013 

VT 

11 

025400 

053 

+ 

43 

006000 

014 

FF 

12 

026000 

054 


44 

006400 

015 

CR 

13 

026400 

055 

- 

45 

007000 

016 

SO 

14 

027000 

056 


46 

007400 

017 

SI 

15 

027400 

057 

/ 

47 

010000 

020 

DLE 

16 

030000 

060 

0 

48 

010400 

021 

DC1 

17 

030400 

061 

1 

49 

011000 

022 

DC2 

18 

031000 

062 

2 

50 

011400 

023 

DC3 

19 

031400 

063 

3 

51 

012000 

024 

DC4 

20 

032000 

064 

4 

52 

012400 

025 

NAK 

21 

032400 

065 

5 

53 

013000 

026 

SYN 

22 

033000 

066 

6 

54 

013400 

027 

ETB 

23 

033400 

067 

7 

55 

014000 

030 

CAN 

24 

034000 

070 

8 

56 

014400 

031 

EM 

25 

034400 

071 

9 

57 

015000 

032 

SUB 

26 

035000 

072 


58 

015400 

033 

ESC 

27 

035400 

073 


59 

016000 

034 

FS 

28 

036000 

074 

< 

60 

016400 

035 

GS 

29 

036400 

075 

= 

61 

017000 

036 

RS 

30 

037000 

076 

> 

62 

017400 

037 

US 

31 

037400 

077 

? 

63 
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ASCII Character Set (cont.) 


Left 

Right 

ASCII 

Right 

Left 

Right 

ASCII 

Right 

Byte 

Octal 

Byte 

Octal 

Char 

Byte 

Decimal 

Byte 

Octal 

Byte 

Octal 

Char 

Byte 

Decimal 

040000 

100 

@ 

64 

060000 

140 


96 

040400 

101 

A 

65 

060400 

141 

a 

97 

041000 

102 

B 

66 

061000 

142 

b 

98 

041400 

103 

C 

67 

061400 

143 

c 

99 

042000 

104 

D 

68 

062000 

144 

d 

100 

042400 

105 

E 

69 

062400 

145 

e 

101 

043000 

106 

F 

70 

063000 

146 

f 

102 

043400 

107 

G 

71 

063400 

147 

g 

103 

044000 

110 

H 

72 

064000 

150 

h 

104 

044400 

111 

1 

73 

064400 

151 

i 

105 

045000 

112 

J 

74 

065000 

152 

j 

106 

045400 

113 

K 

75 

065400 

153 

k 

107 

046000 

114 

L 

76 

066000 

154 

1 

108 

046400 

115 

M 

77 

066400 

155 

m 

109 

047000 

116 

N 

78 

067000 

156 

n 

110 

047400 

117 

0 

79 

067400 

157 

0 

111 

050000 

120 

P 

80 

070000 

160 

P 

112 

050400 

121 

Q 

81 

070400 

161 

q 

113 

051000 

122 

R 

82 

071000 

162 

r 

114 

051400 

123 

S 

83 

071400 

163 

s 

115 

052000 

124 

T 

84 

072000 

164 

t 

116 

052400 

125 

U 

85 

072400 

165 

u 

117 

053000 

126 

V 

86 

073000 

166 

V 

118 

053400 

127 

w 

87 

073400 

167 

w 

119 

054000 

130 

X 

88 

074000 

170 

X 

120 

054400 

131 

Y 

89 

074400 

171 

y 

121 

055000 

132 

z 

90 

075000 

172 

z 

122 

055400 

133 

[ 

91 

075400 

173 

{ 

123 

056000 

134 

\ 

92 

076000 

174 

1 

124 

056400 

135 

] 

93 

076400 

175 

} 

125 

057000 

136 

* 

94 

077000 

176 

" 

126 

057400 

137 


95 

077400 

177 

DEL 

127 
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Left/Right Byte Equivalents 200-377 


Left 

Right 

Right 

Left 

Right 

Right 

Byte 

Byte 

Byte 

Byte 

Byte 

Byte 

Octal 

Octal 

Decimal 

Octal 

Octal 

Decirr 

100000 

200 

128 

120000 

240 

160 

100400 

201 

129 

120400 

241 

161 

101000 

202 

130 

121000 

242 

162 

101400 

203 

131 

121400 

243 

163 

102000 

204 

132 

122000 

244 

164 

102400 

205 

133 

122400 

245 

165 

103000 

206 

134 

123000 

246 

166 

103400 

207 

135 

123400 

247 

167 

104000 

210 

136 

124000 

250 

168 

104400 

211 

137 

124400 

251 

169 

105000 

212 

138 

125000 

252 

170 

105400 

213 

139 

125400 

253 

171 

106000 

214 

140 

126000 

254 

172 

106400 

215 

141 

126400 

255 

173 

107000 

216 

142 

127000 

256 

174 

107400 

217 

143 

127400 

257 

175 

110000 

220 

144 

130000 

260 

176 

110400 

221 

145 

130400 

261 

177 

111000 

222 

146 

131000 

262 

178 

111400 

223 

147 

131400 

263 

179 

112000 

224 

148 

132000 

264 

180 

112400 

225 

149 

132400 

265 

181 

113000 

226 

150 

133000 

266 

182 

113400 

227 

151 

133400 

267 

183 

114000 

230 

152 

134000 

270 

184 

114400 

231 

153 

134400 

271 

185 

115000 

232 

154 

135000 

272 

186 

115400 

233 

155 

135400 

273 

187 

116000 

234 

156 

136000 

274 

188 

116400 

235 

157 

136400 

275 

189 

117000 

236 

158 

137000 

276 

190 

117400 

237 

159 

137400 

277 

191 
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Left/Right Byte Equivalents 200-377 (cont.) 


Left 

Right 

Right 

Left 

Right 

Right 

Byte 

Byte 

Byte 

Byte 

Byte 

Byte 

Octal 

Octal 

Decimal 

Octal 

Octal 

Decimal 

140000 

300 

192 

160000 

340 

224 

140400 

301 

193 

160400 

341 

225 

141000 

302 

194 

161000 

342 

226 

141400 

303 

195 

161400 

343 

227 

142000 

304 

196 

162000 

344 

228 

142400 

305 

197 

162400 

345 

229 

143000 

306 

198 

163000 

346 

230 

143400 

307 

199 

163400 

347 

231 

144000 

310 

200 

164000 

350 

232 

144400 

311 

201 

164400 

351 

233 

145000 

312 

202 

165000 

352 

234 

145400 

313 

203 

165400 

353 

235 

146000 

314 

204 

166000 

354 

236 

146400 

315 

205 

166400 

355 

237 

147000 

316 

206 

167000 

356 

238 

147400 

317 

207 

167400 

357 

239 

150000 

320 

208 

170000 

360 

240 

150400 

321 

209 

170400 

361 

241 

151000 

322 

210 

171000 

362 

242 

151400 

323 

211 

171400 

363 

243 

152000 

324 

212 

172000 

364 

244 

152400 

325 

213 

172400 

365 

245 

153000 

326 

214 

173000 

366 

246 

153400 

327 

215 

173400 

367 

247 

154000 

330 

216 

174000 

370 

248 

154400 

331 

217 

174400 

371 

249 

155000 

332 

218 

175000 

372 

250 

155400 

333 

219 

175400 

373 

251 

156000 

334 

220 

176000 

374 

252 

156400 

335 

221 

176400 

375 

253 

157000 

336 

222 

177000 

376 

254 

157400 

337 

223 

177400 

377 

255 
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Radix-50 Character Set 


Character 

SPACE 

A 

B 

C 

D 

E 

F 

G 

H 

I 

J 

K 

L 

M 

N 

O 

P 

Q 

R 

S 

T 

U 

V 

w 

X 

Y 

z 

$ 

unused 

0 

1 

2 

3 

4 

5 

6 

7 

8 
9 


First 

000000 

003100 

006200 

011300 

014400 

017500 

022600 

025700 

031000 

034100 

037200 

042300 

045400 

050500 

053600 

056700 

062000 

065100 

070200 

073300 

076400 

101500 

104600 

107700 

113000 

116100 

121200 

124300 

127400 

132500 

135600 

140700 

144000 

147100 

152200 

155300 

160400 

163500 

166600 

171700 


Second 

000000 

000050 

000120 

000170 

000240 

000310 

000360 

000430 

000500 

000550 

000620 

000670 

000740 

001010 

001060 

001130 

001200 

001250 

001320 

001370 

001440 

001510 

001560 

001630 

001700 

001750 

002020 

002070 

002140 

002210 

002260 

002330 

002400 

002450 

002520 

002570 

002640 

002710 

002760 

003030 


Third 

000000 
000001 
000002 
000003 
000004 
000005 
000006 
000007 
000010 
000011 
000012 
000013 
000014 
000015 
000016 
000017 
000020 
000021 
000022 
000023 
000024 
000025 
000026 
000027 
000030 
000031 
000032 
000033 
000034 
000035 
000036 
000037 
000040 
000041 
000042 
000043 
000044 
000045 
000046 
000047 






RT-11 Device Names and Codes 


Name 

Code 

Device 

RK 

0 

RK05 Disk 

DT 

1 

TC11 DECtape 

EL 

2 

Error Logger 

LP 

3 

Line Printer 

TT,BA 

4 

Console Terminal or Batch Handler 

DL 

5 

RL01/RL02 Disk 

DY 

6 

RX02 Diskette 

PC 

7 

PC11 Reader/Punch 


10 

Reserved (V2 PP handler) 

MT 

11 

TM11/TMA11/TU10/TS03 Magtape 

RF 

12 

RF11 Disk 

CT 

13 

TA11 DECassette 

CR 

14 

CR11/CM11 Card Reader 


15 

Reserved 

DS 

16 

RJS03/RJS04 Fixed-Head Disk 


17 

Reserved 

MM 

20 

TJU16/TU45 Magtape 

DP 

21 

RP11/RPR02/RP03 Disk 

DX 

22 

RX11/RX01 Diskette 

DM 

23 

RK06/RK07 Disk 


24 

Reserved 

NL 

25 

Null Device 


26-30 

Reserved (DECnet) 


31-33 

Reserved (CTS-300) 

DD 

34 

TU58 DECtape II 

MS 

35 

TS11/TS04 Magtape 

PD 

36 

PDT-11/130 

PD 

37 

PDT-11/150 


40 

Reserved 

LS 

41 

Serial Line Printer 

MQ 

42 

Internal Message Handler 

DR 

43 

DRV11J Interface (MRRT) 

XT 

44 

Reserved (MRRT) 


45 

Reserved 

LD 

46 

Logical Disk Handler 

VM 

47 

KT11 Pseudo-disk Handler 

DU 

50 

MSCP Disk Class Handler (RA80, RC25) 

SL 

51 

Single-line Editor 
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Standard RT-11 File Types 

.ANS SYSGEN answer file 

•BAD File with bad blocks 

•BAK Editor backup file 

•BAT BATCH command file 

BUP Backup Utility Program output file 

•CND System generation conditional file 

•COM Indirect command file, IND control file, SIPP indirect file 

•CTL BATCH control file (generated from .BAT file) 

CTT BATCH temporary file 

•DAT BASIC, FORTRAN, or IND data file, ELINIT statistics file 
.DEV SYSGEN handler build procedure 

■ DIF SRCCOM, BINCOM output file 

■DIR Directory listing file 

.DMP DUMP output file 

■ DSK Logical disk file 

■JOB QUEUE output file 

■LDA Absolute binary file 

•LOG BATCH log file 

■ LST Listing file, SLP output file 

MAC MACRO source file 

■MAP LINK load map 

.MLB MACRO library file 

.MON SYSGEN monitor build procedure 

•OBJ Relocatable binary file 

.REL Foreground job relocatable file 

■SAV Memory image program file 

■SLP SLP command file created by SRCCOM 

•SML System macro library 

■SOU Temporary BATCH file 

■STB Symbol table file 

■SYG Monitor and handler files created by SYSGEN 

•SYS System files and handlers 

.TBL SYSGEN device table file 

■TEC TECO macro file 

•TMP Temporary file 

•TXT Text file 


265 






Interrupt Vectors 


4,6 

CPU errors, odd address trap 

10,12 

Illegal and reserved instruction trap 

14,16 

BPT, breakpoint trap 

20,22 

IOT, input/output trap 

24,26 

Power fail 

30,32 

EMT instructions 

34,36 

TRAP instructions 

40-56 

Reserved 

60,62 

DL11: Console terminal input 

64,66 

DL11: Console terminal output 

70,72 

PC11: Paper tape reader 

74,76 

PC11: Paper tape punch 

100,102 

KW11-L: Line clock 

104,106 

KW11-P: Programmable clock 

110,112 

Reserved 

114,116 

Memory parity errors 

120,122 

XY11: X/Y plotter 

124,126 

DR11-B: DMA interface 

130,132 

AD01: A-D subsystem 

134,136 

AFC11: Analog subsystem 

140,142 

AA11: D-A subsystem 

144,146 

AA11: (requires two vectors) 

150,152 

RA80, RC25 port number 1 

154,156 

RA80, RC25 port number 0 

160,162 

RL11: RL01/RL02 disk 

164,166 

Reserved 

170,172 

LP/LS/LV: Line printer number 1 

174,176 

LP/LS/LV: Line printer number 2 

200,202 

LP11/LSI 1/LPV11: Line printer number 0 

204,206 

RH11.RH70: RS03/04 disk 

210,212 

RK611/RK711: RK06/RK07 disk 

214,216 

TC11: DECtape 

220,222 

RK11/RKV11: RK05 disk 

224,226 

Magtape 

230,232 

CD11/CM11/CR11: Card reader 

234,236 

UDC11: Digital control subsystem 
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Interrupt Vectors (cont.) 

240,242 PIRQ (programmed interrupt request) 

244,246 FPP/FIS floating-point exception 

250,252 KT11: Memory management fault 

254,256 RP11: RP02/03 disk 

RH11/RH70: RP04/05/06/RM02/03 disk 
260,262 TA11: Cassette tape 

264,266 RX11 /RXV11 /RX211 /RX2V1: RX01 /02 diskette 

270,272 LP/LS/LV: Line printer number 3 

274,276 LP/LS/LV: Line printer number 4 

300,302 Start of floating vector area 

320,322 VT11/VS60: Graphics terminal 

324,326 VT11/VS60 

330,332 VT11/VS60 
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K Equivalents 


K-value 

Octal 

Decimal 

1 

2000 

1024 

2 

4000 

2048 

3 

6000 

3072 

4 

10000 

4096 

5 

12000 

5120 

6 

14000 

6144 

7 

16000 

7168 

8 

20000 

8192 

9 

22000 

9216 

10 

24000 

10240 

11 

26000 

11264 

12 

30000 

12288 

13 

32000 

13312 

14 

34000 

14336 

15 

36000 

15360 

16 

40000 

16384 

17 

42000 

17408 

18 

44000 

18432 

19 

46000 

19456 

20 

50000 

20480 

21 

52000 

21504 

22 

54000 

22528 

23 

56000 

23552 

24 

60000 

24576 

25 

62000 

25600 

26 

64000 

26624 

27 

66000 

27648 

28 

70000 

28672 

29 

72000 

29696 

30 

74000 

30720 

31 

76000 

31744 

32 

00000 

32768 

33 

102000 

33792 

34 

104000 

34816 

35 

106000 

35840 

36 

110000 

36864 

37 

112000 

37888 

38 

114000 

38912 

39 

116000 

39936 

40 

120000 

40960 

41 

122000 

41984 

42 

124000 

43008 

43 

126000 

44032 

44 

130000 

45056 

45 

132000 

46080 


K-value 

Octal 

Decimal 

46 

134000 

47104 

47 

136000 

48128 

48 

140000 

49152 

49 

142000 

50176 

50 

144000 

51200 

51 

146000 

52224 

52 

150000 

53248 

53 

152000 

54272 

54 

154000 

55296 

55 

156000 

56320 

56 

160000 

57344 

57 

162000 

58368 

58 

164000 

59392 

59 

166000 

60416 

60 

170000 

61440 

61 

172000 

62464 

62 

174000 

63488 

63 

176000 

64512 

64 

200000 

65536 

65 

202000 

66560 

66 

204000 

67584 

67 

206000 

68608 

68 

210000 

69632 

69 

212000 

70656 

70 

214000 

71680 

71 

216000 

72704 

72 

220000 

73728 

73 

222000 

74752 

74 

224000 

75776 

75 

226000 

76800 

76 

230000 

77824 

77 

232000 

78848 

78 

234000 

79872 

79 

236000 

80896 

80 

240000 

81920 

81 

242000 

82944 

82 

244000 

83968 

83 

246000 

84992 

84 

250000 

86016 

85 

252000 

87040 

86 

254000 

88064 

87 

256000 

89088 

88 

260000 

90112 

89 

262000 

91136 

90 

264000 

92160 
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K Equivalents (cont.) 


K-value 

Octal 

Decimal 

K-value 

Octal 

Decimal 

91 

266000 

93184 

140 

430000 

143360 

92 

270000 

94208 

144 

440000 

147456 

93 

272000 

95232 

148 

450000 

151552 

94 

95 

274000 

276000 

96256 

97280 

152 

446000 

155648 

96 

300000 

98304 

156 

470000 

159744 

97 

302000 

99328 

160 

500000 

163840 

98 

304000 

100352 

164 

510000 

167936 

99 

306000 

101376 

168 

520000 

172032 

100 

310000 

102400 

172 

530000 

176128 

101 

312000 

103424 

176 

540000 

180224 

102 

314000 

104448 

180 

550000 

184320 

103 

316000 

105472 

184 

560000 

188416 

104 

320000 

106496 

188 

570000 

192512 

105 

322000 

107520 

192 

600000 

196608 

106 

324000 

108544 

196 

610000 

200704 

107 

326000 

109568 

200 

620000 

204800 

108 

330000 

110592 

204 

630000 

208896 

109 

332000 

111616 

208 

640000 

212992 

110 

334000 

112640 

212 

650000 

217088 

111 

336000 

113664 

216 

660000 

211184 

112 

340000 

114688 

220 

670000 

225280 

113 

342000 

115712 

224 

700000 

229376 

114 

344000 

116736 

228 

710000 

233472 

115 

346000 

117760 

232 

720000 

237568 

116 

350000 

118784 

236 

730000 

241664 

117 

352000 

119808 

240 

740000 

245760 

118 

354000 

120832 

244 

750000 

249856 

119 

356000 

121856 

248 

760000 

253952 

120 

360000 

122880 

252 

770000 

258048 

121 

362000 

123904 

256 

1000000 

262144 

122 

364000 

124928 




123 

366000 

125952 




124 

370000 

126976 




125 

372000 

128000 




126 

374000 

129024 




127 

376000 

130048 




128 

400000 

131072 




132 

410000 

135168 




136 

420000 

139264 
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